Anular una orden de compra
Anula una orden abierta o dada por perdida, como anular una factura
finalizada en Stripe; un borrador no se anula, se elimina con
DELETE /purchase_orders/{id}. Primero se
anula su factura ante la SAT (o, pasado el plazo de anulación, se emite
una nota de crédito); luego su link deja de recibir pagos y la página del
comprador dice que se anuló.
Authentication
Tu clave secreta de API.
Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.
Path parameters
Headers
ID de una cuenta hija conectada. Ejecuta el request dentro de esa cuenta,
como Stripe-Account en Stripe Connect. La plataforma puede acceder a
todos los recursos API que pertenecen a la hija, sin filtrar por creador.
Solo aplica a hijas directas: si la cuenta no está conectada a la tuya,
el request responde 404 con code: connected_account_not_found.
Con una llave de organización este header nombra la cuenta miembro sobre
la que quieres operar; si no pertenece a la organización, el request
responde 404 con code: organization_account_not_found. En una lectura
puedes omitirlo para abarcar todas las cuentas de la organización.
Request
Por qué se anula, para tu registro
Response
draft no se ha enviado (o su factura no se certificó); open se
envió y se debe; paid se pagó, con su link o afuera; void se
anuló; uncollectible se dio por perdida, aunque su link sigue
cobrando.
Abierta y con la fecha de vencimiento ya pasada. «Vencida» no es un estado.
Número de la orden con su prefijo, como lo ve el comprador
Referencia inmutable del ERP; también se incluye en los webhooks
Qué vende, como lo lee el comprador
La metadata que tu integración le puso
Lo que se registró como pagado fuera de Recurrente, en centavos
Lo que el comprador todavía debe, en centavos. 0 si está pagada o anulada.
Pagos registrados fuera de Recurrente, del más antiguo al más reciente
Días de crédito desde que se envió. null cuando la orden tiene una fecha de vencimiento propia.
Fecha en que se envió. null en borrador.
Fecha en que el comprador prometió pagar, si la registraste en el dashboard
Los recordatorios automáticos están en pausa
Por qué se anuló
Nombre o razón social del comprador como se escribió en la orden (lo que envió buyer_name, o el nombre del cliente). Renombrar al cliente después no lo cambia.
Correo al que se envía la orden
WhatsApp al que se envía la orden
NIT de la factura. null es consumidor final.
El número con el que el comprador archiva su orden de compra
La orden se envía con factura electrónica
La factura de la orden tal como está (el último intento de certificarla). null si no se ha intentado.

