Ejemplos por país

📄 Ciclo de facturación

Ciclo de vida de la emisión de facturas

Perú tiene un sistema de facturación sincrónico, lo que significa que los documentos serán verificados de inmediato en el momento en que los emita.

Los pasos son los siguientes; puede identificarlos usando 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 (SUNAT)

{
    "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 (SUNAT)

{
    "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.