Documentos Recibidos

Compras

Cómo gestionar las facturas de compra utilizando el API de TAXO WS

Para gestionar las facturas de compra utilizando el API de TAXO WS, puedes seguir este ejemplo práctico que muestra cómo hacer una petición POST para crear una tarea que descargará el tipo de documento seleccionado.

El campo startDownloadAt define el rango de descarga:
  • Si se ingresa solo año y mes (ej. "2025-02"), se descargarán todas las facturas del mes especificado.
  • Si se ingresa año, mes y día (ej. "2025-02-03"), solo se descargarán las facturas de ese día específico.

Crear solicitud de la tarea

Javascript
const axios = require('axios');
let data = JSON.stringify({
  "type": "PURCHASE.BILL",
  "taxpayerId": "1719932093001",
  "startDownloadAt": "2025-02"
});

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

JSON
{
  "taxpayerId": "1719932093001",
  "type": "PURCHASE.BILL",
  "creatstartDownloadAtedAt": "2025-02",
  "triggerMethod": "MANUAL",
}

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