Skip to main content
GET
/
api
/
v1
/
invoices
/
{number}
/
events
curl -X GET https://api.yourapp.com/api/v1/invoices/FACT-12345/events \
  -H "Authorization: Bearer <local_jwt>" \
  -H "X-Factus-Token: <factus_access_token>"
{
  "message": "Eventos de factura obtenidos exitosamente",
  "data": {
    "status": "success",
    "message": "Events retrieved successfully",
    "data": [
      {
        "number": "EV-001",
        "cude": "xyz789abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
        "event_code": "030",
        "event_name": "Acuse de recibo",
        "effective_date": "2024-01-15",
        "effective_time": "10:30:00"
      },
      {
        "number": "EV-002",
        "cude": "mno345pqr678stu901vwx234yzabc123def456ghi789jkl012xyz789",
        "event_code": "031",
        "event_name": "Recibo del bien o prestación del servicio",
        "effective_date": "2024-01-16",
        "effective_time": "14:15:00"
      },
      {
        "number": "EV-003",
        "cude": "def456ghi789jkl012xyz789mno345pqr678stu901vwx234yzabc123",
        "event_code": "032",
        "event_name": "Aceptación expresa",
        "effective_date": "2024-01-17",
        "effective_time": "09:45:00"
      }
    ]
  }
}

Headers

Authorization
string
required
Bearer token for authentication: Bearer <local_jwt>
X-Factus-Token
string
required
Factus access token obtained from authentication

Path Parameters

number
string
required
The invoice number to retrieve events for

Response

message
string
Success message
data
object
Invoice events response
curl -X GET https://api.yourapp.com/api/v1/invoices/FACT-12345/events \
  -H "Authorization: Bearer <local_jwt>" \
  -H "X-Factus-Token: <factus_access_token>"
{
  "message": "Eventos de factura obtenidos exitosamente",
  "data": {
    "status": "success",
    "message": "Events retrieved successfully",
    "data": [
      {
        "number": "EV-001",
        "cude": "xyz789abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
        "event_code": "030",
        "event_name": "Acuse de recibo",
        "effective_date": "2024-01-15",
        "effective_time": "10:30:00"
      },
      {
        "number": "EV-002",
        "cude": "mno345pqr678stu901vwx234yzabc123def456ghi789jkl012xyz789",
        "event_code": "031",
        "event_name": "Recibo del bien o prestación del servicio",
        "effective_date": "2024-01-16",
        "effective_time": "14:15:00"
      },
      {
        "number": "EV-003",
        "cude": "def456ghi789jkl012xyz789mno345pqr678stu901vwx234yzabc123",
        "event_code": "032",
        "event_name": "Aceptación expresa",
        "effective_date": "2024-01-17",
        "effective_time": "09:45:00"
      }
    ]
  }
}

Common Event Codes

  • 030: Acuse de recibo (Acknowledgment of receipt)
  • 031: Recibo del bien o prestación del servicio (Receipt of goods or services)
  • 032: Aceptación expresa (Express acceptance)
  • 033: Aceptación tácita (Tacit acceptance)
  • 034: Reclamo de la factura electrónica de venta (Invoice claim)
  • 035: Rechazo de la factura electrónica de venta (Invoice rejection)

Build docs developers (and LLMs) love