Régimen Fiscal

Este endpoint inicia una tarea asíncrona para consultar el régimen tributario de un contribuyente, identificado por su ID. La confirmación de la tarea se da inmediatamente, y el resultado final se entregará mediante un Webhook.

Detalles Técnicos

Endpoint y Método

• Método: POST
• Endpoint: /tasks

Headers Requeridos

• Content-Type: application/json
• x-api-key: [Tu Clave de Autenticación] - Para la autorización

Estructura del Body/Payload

El cuerpo de la solicitud (payload) es un objeto JSON que requiere dos campos:

• type (string): Debe ser el valor "TAXPAYER.REGIMEN"
• taxpayerId (string): 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.REGIMEN",
  "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 inmediata es una confirmación de que la tarea ha sido creada:

{
  "status": "success",
  "data": {
    "id": "48ada898-b2a3-4f02-a12c-8431d38b599d",
    "createdAt": "2025-11-13T16:20:19.000Z",
    "status": "INITIALIZED"
  }
}

Campos de la Respuesta

• status (string): Indica el éxito de la solicitud de creación de la tarea ("success")
• data.id (string): El ID único para el seguimiento de la tarea
• data.createdAt (string): La marca de tiempo de la creación
• data.status (string): El estado inicial de la tarea, siempre "INITIALIZED"

Código de Respuesta HTTP

201 Created: Este es el código principal esperado, ya que se está creando un nuevo recurso (la tarea asíncrona) en el servidor.

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.