Ejemplos por país

📄 Ciclo de facturación

Ciclo de vida de la emisión de facturas

Colombia tiene un sistema de facturación sincrónico, lo que significa que los documentos serán verificados de forma inmediata al emitirlos.

Los pasos son los siguientes; puede identificarlos utilizando GET /documents y leyendo los campos.

Consultar documento

• Endpoint: https://api-billing.koywe.com/V1/documents/{document_id}

1) Borrador

{
    "header": {
      "document_status" : 0
    }
}

2) Emitido, pendiente de validación

{
    "header": {
    "document_status" : 1
    }
}

El documento tiene todos los campos requeridos y fue emitido por nuestro sistema; será enviado a la autoridad tributaria en unos minutos. No se requiere ninguna acción de su parte.

3) Aprobado por la autoridad tributaria (DIAN)

{
    "header": {
        "document_status" : 1,
        "taxbureau_send_status": 1,
        "taxbureau_send_id": "XXXXXX",
        "taxbureau_send_date": "AAAA-MM-DD",
        "taxbureau_validation_status": 3
    }
}

El documento ha completado su ciclo exitosamente; no se requiere ninguna acción adicional.

3B) Rechazado por la autoridad tributaria (DIAN)

{
    "header": {
        "document_status" : 1,
        "taxbureau_send_status": 1,
        "taxbureau_send_id": "XXXXXX",
        "taxbureau_send_date": "AAAA-MM-DD",
        "taxbureau_validation_status": 5,
        "taxbureau_validation_comments": "XXXXX"
    }
}

El documento fue rechazado; encontrará más información en el campo de comentarios. En este caso, el documento debe ser emitido y enviado nuevamente.