> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.recurrente.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server.

# Orden de compra anulada

POST 

Se emite cuando una orden enviada se anula: su factura se anuló ante la SAT y su link dejó de cobrar.

Reference: https://docs.recurrente.com/referencia-api/api-reference/webhook-events/purchase-order-voided-webhook

## Request

### Payload

- `event_type` (string, required) — Tipo exacto del evento enviado por Recurrente.
- `id` (string, required) — ID de la orden de compra
- `status` (enum, required) — `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.
  - Allowed values: `draft`, `open`, `paid`, `void`, `uncollectible`
- `api_version` (string, required)
- `connected` (boolean, optional, nullable) — Presente como `true` cuando el evento proviene de una cuenta conectada.
- `account_id` (string, optional, nullable) — ID de la cuenta conectada que originó el evento.
- `overdue` (boolean, optional) — Abierta y con la fecha de vencimiento ya pasada. «Vencida» no es un estado.
- `reference` (string, optional) — Número de la orden con su prefijo, como lo ve el comprador
- `external_reference` (string, optional, nullable) — Referencia inmutable del ERP; también se incluye en los webhooks
- `prefix` (string, optional)
- `number` (integer, optional) — Consecutivo de la orden en tu cuenta
- `description` (string, optional, nullable) — Qué vende, como lo lee el comprador
- `checkout_url` (string, optional) — Link donde el comprador paga la orden. No vence mientras la orden se deba.
- `metadata` (map from string to any, optional) — La metadata que tu integración le puso
- `currency` (string, optional)
- `total_in_cents` (integer, optional) — Total de la orden, en centavos
- `amount_paid_out_of_band_in_cents` (integer, optional) — Lo que se registró como pagado fuera de Recurrente, en centavos
- `amount_remaining_in_cents` (integer, optional) — Lo que el comprador todavía debe, en centavos. `0` si está pagada o anulada.
- `payments` (list of PurchaseOrderPayment, optional) — Pagos registrados fuera de Recurrente, del más antiguo al más reciente
- `net_days` (integer, optional, nullable) — Días de crédito desde que se envió. `null` cuando la orden tiene una fecha de vencimiento propia.
- `issued_on` (date, optional, nullable) — Fecha en que se envió. `null` en borrador.
- `due_on` (date, optional, nullable) — Fecha de vencimiento
- `promised_on` (date, optional, nullable) — Fecha en que el comprador prometió pagar, si la registraste en el dashboard
- `reminders_paused` (boolean, optional) — Los recordatorios automáticos están en pausa
- `void_reason` (string, optional, nullable) — Por qué se anuló
- `customer_id` (string, optional) — ID del cliente comprador
- `buyer_name` (string, optional) — 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.
- `buyer_email` (string, optional, nullable) — Correo al que se envía la orden
- `buyer_phone` (string, optional, nullable) — WhatsApp al que se envía la orden
- `buyer_tax_id` (string, optional, nullable) — NIT de la factura. `null` es consumidor final.
- `buyer_reference` (string, optional, nullable) — El número con el que el comprador archiva su orden de compra
- `cc_emails` (list of string, optional) — Correos que reciben copia
- `tax_invoice_requested` (boolean, optional) — La orden se envía con factura electrónica
- `tax_invoice` (PurchaseOrderTaxInvoice, optional, nullable) — La factura de la orden tal como está (el último intento de certificarla). `null` si no se ha intentado.
- `sent_at` (datetime, optional, nullable)
- `paid_at` (datetime, optional, nullable)
- `voided_at` (datetime, optional, nullable)
- `uncollectible_at` (datetime, optional, nullable)
- `created_at` (datetime, optional)
- `updated_at` (datetime, optional)

## Types

### PurchaseOrderPayment

Un pago que el comprador hizo fuera de Recurrente, como lo registró el comercio. No movió dinero en Recurrente.

- `amount_in_cents` (integer, optional)
- `currency` (string, optional)
- `paid_on` (date, optional)
- `payment_method` (enum, optional)
  - Allowed values: `transfer`, `deposit`, `cheque`, `cash`, `other`
- `reference` (string, optional, nullable)
- `note` (string, optional, nullable)
- `created_at` (datetime, optional)

### PurchaseOrderTaxInvoice

La factura electrónica de una orden de compra. En un Sandbox es simulada y no tiene página pública.

- `status` (enum, optional) — `pending`, `issued` (certificada), `failed` (no se certificó: ver `error_message`) o `voided` (anulada ante la SAT)
  - Allowed values: `pending`, `issued`, `failed`, `voided`
- `uuid` (string, optional, nullable) — Número de autorización que da la SAT
- `series` (string, optional, nullable) — Serie de la SAT
- `number` (string, optional, nullable) — Número de la SAT
- `url` (string, optional, nullable) — Página pública de la factura
- `error_code` (enum, optional, nullable) — Por qué no se certificó, cuando `status` es `failed`: `service_unavailable` (vuelve a enviarla en unos minutos), `buyer_tax_id_invalid` (la SAT no reconoce el NIT del comprador), `buyer_tax_id_required` (arriba de Q2,500 la factura necesita el NIT), `account_action_required` (algo de tu cuenta ante la SAT; `error_message` dice qué) o `processing_error` (lo estamos revisando).
  - Allowed values: `service_unavailable`, `buyer_tax_id_invalid`, `buyer_tax_id_required`, `account_action_required`, `processing_error`
- `error_message` (string, optional, nullable) — Qué hacer, en una frase para mostrarle al comercio, cuando `status` es `failed`
- `issued_at` (datetime, optional, nullable)