Admitir PosDebitNote
/v1/pos-debit-notesEstado: parcial. Ambientes: qualification. Permisos: documents:write.
Alcance: Solo qualification, sobre un tiquete P.O.S. propio validado, con las mismas reglas de la nota débito de factura: sin nota crédito activa ni más de una débito sin resolver. Consecutivo interno del emisor (tipo pos_debit_note) con configuración SendBillSync. Sin prueba de extremo a extremo propia: comparte admisión y firma con la nota de ajuste crédito. No admite customer_id (422 CUSTOMER_ID_NOT_SUPPORTED): el comprador debe repetir el del original.
202 admite una revisión de forma durable y reserva saldo. La DIAN responde después. Mismo Idempotency-Key o referencia equivalente recupera la admisión original sin nueva reserva, aunque el cliente guardado haya cambiado o se haya archivado después. No transmitir si la capability no está habilitada. Solo buyer completo: customer_id responde 422 CUSTOMER_ID_NOT_SUPPORTED porque el comprador debe coincidir con el del original.
Authorization
ClientApiKey Secreto ligado a empresa, actor, permisos y ambiente. No admite cambiar empresa por body/header.
In: header
Header Parameters
Obligatoria en mutaciones. Alcance: empresa/ambiente/operación/recurso destino. Retención mínima 90 días y mientras haya trabajo pendiente. Mismo contenido recupera resultado; contenido diferente produce 409.
^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$1 <= length <= 128Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Nota de ajuste débito al documento equivalente P.O.S. propio. original_document_id apunta a un tiquete validado, que se referencia por su CUDE. Se numera con la secuencia interna del emisor, sin autorización de numeración DIAN. Motivos del anexo: 1 devolución o no aceptación parcial, 2 anulación del documento equivalente, 3 rebaja o descuento, 4 ajuste de precio, 5 otros. No se aceptan documentos de otro emisor en este perfil.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/pos-debit-notes" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "document_type": "pos_debit_note", "external_reference": "DEMO-POS-DEBIT-001", "profile_id": "co-pos-adjustment-cop-v1", "numbering_range_id": "00000000-0000-4000-8000-000000000015", "issued_at": "2026-09-11T09:15:00-05:00", "currency": "COP", "buyer": { "party_type": "person", "identification": { "type_code": "13", "number": "1000000000" }, "name": "Comprador de ejemplo", "email": "comprador@example.com", "tax_registration": { "responsibility_codes": [ "R-99-PN" ], "tax_scheme_codes": [ "01" ] } }, "lines": [ { "id": "1", "description": "Ajuste de precio de bandeja paisa, datos ficticios", "product_identification": { "scheme_code": "999", "value": "DEMO-POS-001" }, "quantity": "2", "unit_code": "94", "unit_price": "1000.00", "price_base_quantity": "1", "net_amount": "2000.00", "adjustments": [], "taxes": [ { "code": "01", "rate": "19", "taxable_amount": "2000.00", "amount": "380.00" } ], "withholdings": [], "original_line_id": "1" } ], "adjustments": [], "tax_totals": [ { "code": "01", "rate": "19", "taxable_amount": "2000.00", "amount": "380.00" } ], "withholding_totals": [], "totals": { "line_extension_amount": "2000.00", "tax_exclusive_amount": "2000.00", "tax_inclusive_amount": "2380.00", "allowance_total_amount": "0.00", "charge_total_amount": "0.00", "prepaid_amount": "0.00", "payable_rounding_amount": "0.00", "payable_amount": "2380.00" }, "payment": { "terms": "cash", "means_code": "10" }, "delivery": { "mode": "cufy_email", "recipients": [ "comprador@example.com" ] }, "point_of_sale": { "register_id": "CAJA-01", "location": "Salón principal", "cashier": "Cajero de ejemplo", "register_type": "Caja principal", "sale_code": "VENTA-000123" }, "original_document_id": "00000000-0000-4000-8000-000000000022", "discrepancy_reason": { "code": "4", "description": "Ajuste de precio de un tiquete P.O.S. de ejemplo", "reference_id": "1" }, "adjustment_scope": "partial" }'{ "operation_id": "cb4ede3c-a5d1-45e3-a9d2-fe83accbce52", "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6", "revision": 1, "version": 1, "environment": "simulation", "external_reference": "string", "processing_status": "queued", "dian_status": "not_sent", "billing_status": "not_reserved", "created_at": "2019-08-24T14:15:22Z", "status_url": "../dictionary"}Admitir PosCreditNote POST
**Estado:** parcial. **Ambientes:** qualification. **Permisos:** `documents:write`. **Alcance:** Solo qualification, sobre un tiquete P.O.S. propio validado. Consecutivo interno del emisor (tipo pos_credit_note, clase note_sequence) con configuración SendBillSync. Referencia al tiquete por su CUDE con DocumentTypeCode 20; motivos del anexo 1 a 5. Conserva exactamente el comprador del tiquete. No admite customer_id (422 CUSTOMER_ID_NOT_SUPPORTED): el comprador debe repetir el del original. 202 admite una revisión de forma durable y reserva saldo. La DIAN responde después. Mismo Idempotency-Key o referencia equivalente recupera la admisión original sin nueva reserva, aunque el cliente guardado haya cambiado o se haya archivado después. No transmitir si la capability no está habilitada. Solo buyer completo: customer_id responde 422 CUSTOMER_ID_NOT_SUPPORTED porque el comprador debe coincidir con el del original.
Consultar ejecución por operation_id GET
**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `documents:read`. **Alcance:** Solo consulta operaciones de admisión documental y exige documents:read. Las operaciones de compras, certificados, empresa, solicitudes de producción y exportaciones descritas por el contrato aún no están conectadas. Dentro de la empresa/ambiente de la credencial se exige el permiso de lectura de la clase de recurso destino. No se acumulan permisos de otras clases ni se concede lectura por conocer operation_id.