curl https://api.onepay.la/v1/invoices/inv_01J8XK9V4N \
-H "Authorization: Bearer $ONEPAY_API_KEY"
{
"id": "inv_01J8XK9V4N",
"status": "PAID",
"fiscal_status": "accepted",
"stamp_policy": "on_payment",
"currency": "COP",
"due_date": "2026-08-16",
"customer": {
"id": "cus_01J8XK2P9WQZ",
"name": "Ana Ramírez",
"email": "ana@ejemplo.com",
"document_type": "CC",
"document_number": "1020304050"
},
"items": [
{
"description": "Plan Fibra 200 Mbps",
"quantity": 1,
"unit_amount": 8990000,
"subtotal": 8990000,
"tax_type": "IVA",
"tax_rate": 19,
"tax_amount": 1708100,
"total": 10698100,
"unit_measure": "94"
}
],
"totals": { "subtotal": 23990000, "tax_amount": 4558100, "total": 28548100 },
"amount": 285481,
"payment_id": "pay_01J8XKC5D2",
"stampings": [
{
"id": "stm_01J8XKB2R7",
"type": "credit_note",
"status": "accepted",
"number": "NC900",
"cufe": "d7b2f4a9...",
"replaces_id": "stm_01J8XKA1Q3",
"total": 15000000,
"stamped_at": "2026-08-05T10:14:02+00:00"
},
{
"id": "stm_01J8XKA1Q3",
"type": "invoice",
"status": "accepted",
"number": "FE1",
"cufe": "a3f5c8e2...",
"xml_url": "https://...",
"pdf_url": "https://...",
"replaces_id": null,
"total": 28548100,
"stamped_at": "2026-08-02T09:03:44+00:00",
"sent_at": "2026-08-02T09:03:51+00:00"
}
],
"created_at": "2026-08-01T14:22:10+00:00"
}
Consultar factura
Devuelve la factura con sus líneas y su historial fiscal.
GET
/
invoices
/
{invoice}
curl https://api.onepay.la/v1/invoices/inv_01J8XK9V4N \
-H "Authorization: Bearer $ONEPAY_API_KEY"
{
"id": "inv_01J8XK9V4N",
"status": "PAID",
"fiscal_status": "accepted",
"stamp_policy": "on_payment",
"currency": "COP",
"due_date": "2026-08-16",
"customer": {
"id": "cus_01J8XK2P9WQZ",
"name": "Ana Ramírez",
"email": "ana@ejemplo.com",
"document_type": "CC",
"document_number": "1020304050"
},
"items": [
{
"description": "Plan Fibra 200 Mbps",
"quantity": 1,
"unit_amount": 8990000,
"subtotal": 8990000,
"tax_type": "IVA",
"tax_rate": 19,
"tax_amount": 1708100,
"total": 10698100,
"unit_measure": "94"
}
],
"totals": { "subtotal": 23990000, "tax_amount": 4558100, "total": 28548100 },
"amount": 285481,
"payment_id": "pay_01J8XKC5D2",
"stampings": [
{
"id": "stm_01J8XKB2R7",
"type": "credit_note",
"status": "accepted",
"number": "NC900",
"cufe": "d7b2f4a9...",
"replaces_id": "stm_01J8XKA1Q3",
"total": 15000000,
"stamped_at": "2026-08-05T10:14:02+00:00"
},
{
"id": "stm_01J8XKA1Q3",
"type": "invoice",
"status": "accepted",
"number": "FE1",
"cufe": "a3f5c8e2...",
"xml_url": "https://...",
"pdf_url": "https://...",
"replaces_id": null,
"total": 28548100,
"stamped_at": "2026-08-02T09:03:44+00:00",
"sent_at": "2026-08-02T09:03:51+00:00"
}
],
"created_at": "2026-08-01T14:22:10+00:00"
}
Es el mismo endpoint de detalle de siempre. Sobre una factura emitida por OnePay agrega el bloque fiscal.
El arreglo
No uses este endpoint para esperar el CUFE. El timbrado es asíncrono y el resultado te llega por el webhook
invoice.stamped; hacer polling acá solo gasta requests.stampings trae el historial fiscal completo, del más nuevo al más viejo: la factura de venta y cada nota crédito o débito que la corrige.
curl https://api.onepay.la/v1/invoices/inv_01J8XK9V4N \
-H "Authorization: Bearer $ONEPAY_API_KEY"
{
"id": "inv_01J8XK9V4N",
"status": "PAID",
"fiscal_status": "accepted",
"stamp_policy": "on_payment",
"currency": "COP",
"due_date": "2026-08-16",
"customer": {
"id": "cus_01J8XK2P9WQZ",
"name": "Ana Ramírez",
"email": "ana@ejemplo.com",
"document_type": "CC",
"document_number": "1020304050"
},
"items": [
{
"description": "Plan Fibra 200 Mbps",
"quantity": 1,
"unit_amount": 8990000,
"subtotal": 8990000,
"tax_type": "IVA",
"tax_rate": 19,
"tax_amount": 1708100,
"total": 10698100,
"unit_measure": "94"
}
],
"totals": { "subtotal": 23990000, "tax_amount": 4558100, "total": 28548100 },
"amount": 285481,
"payment_id": "pay_01J8XKC5D2",
"stampings": [
{
"id": "stm_01J8XKB2R7",
"type": "credit_note",
"status": "accepted",
"number": "NC900",
"cufe": "d7b2f4a9...",
"replaces_id": "stm_01J8XKA1Q3",
"total": 15000000,
"stamped_at": "2026-08-05T10:14:02+00:00"
},
{
"id": "stm_01J8XKA1Q3",
"type": "invoice",
"status": "accepted",
"number": "FE1",
"cufe": "a3f5c8e2...",
"xml_url": "https://...",
"pdf_url": "https://...",
"replaces_id": null,
"total": 28548100,
"stamped_at": "2026-08-02T09:03:44+00:00",
"sent_at": "2026-08-02T09:03:51+00:00"
}
],
"created_at": "2026-08-01T14:22:10+00:00"
}
Was this page helpful?
⌘I