Obligaciones Fiscales

Este endpoint se utiliza para solicitar la consulta asíncrona de las obligaciones fiscales (tributarias) de un contribuyente específico, identificado por su ID. La respuesta inmediata confirma la creación de la tarea, y el detalle de las obligaciones será notificado a través de un Webhook.

Detalles Técnicos

Endpoint y Método

• Método: POST
• Endpoint: /tasks - Es la puerta de entrada para todas las tareas

Headers Requeridos

• Content-Type: application/json - Necesario para enviar el JSON
• x-api-key: [Tu Clave] - Tu pase de acceso, ¡mantenlo seguro!

Estructura del Body/Payload

El payload es idéntico a la tarea anterior, solo cambia el tipo:

• type (string, requerido): Define el tipo de consulta. El valor debe ser "TAXPAYER.OBLIGATIONS"
• taxpayerId (string, requerido): El número de identificación fiscal del cliente (ejemplo: "1726051285001")

Código de Ejemplo

const axios = require('axios');
let data = JSON.stringify({
  "type": "TAXPAYER.OBLIGATIONS",
  "taxpayerId": "1726051285001"
});

let config = {
  method: 'post',
  url: 'https://staging-api.taxo.ws/tasks',
  headers: { 
    'x-api-key': 'tu_api_key', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Respuesta de la solicitud

La respuesta es la confirmación inmediata de la creación de la tarea, siguiendo el mismo estándar asíncrono:

{
  "status": "success",
  "data": {
    "id": "dd4dffb7-a437-4f21-87be-bc4404f68e47",
    "createdAt": "2025-11-13T16:23:07.000Z",
    "status": "INITIALIZED"
  }
}

Campos de la Respuesta

• status (string): El estado general de la solicitud de creación ("success")
• data.id (string): El identificador único de esta tarea de consulta de obligaciones
• data.createdAt (string): La marca de tiempo en formato ISO 8601
• data.status (string): El estado inicial de la tarea, siempre "INITIALIZED"

Código de Respuesta HTTP

201 Created: Este código indica que la solicitud ha sido procesada exitosamente y se ha creado un nuevo recurso de tarea en el servidor. Es el código ideal para solicitudes asíncronas.

Por defecto todas las tareas de consultas empiezan en el estado INITIALIZED que nos indica que la tarea ha sido iniciada y podemos hacer su seguimiento en el webhook.