Registra un consumo externo (ej. restaurante o bar) sobre la reserva de un huésped hospedado, cuando el huésped pide cargarlo a su habitación. El consumo queda como cuenta por cobrar en estado pending, visible en la reserva para que recepción lo cobre manualmente. Se autentica con el API Key de integración externa (header X-Api-Key) y con el token del socio de consumo que registra el cargo (header X-Api-Token).

Los reintentos son idempotentes: si se envía de nuevo un consumo con la misma reserva, partner y external_reference, y los mismos room_name, identification_number, description, amount e invoice_pdf_url, no se crea otro y responde 200 con el id del existente. consumed_at no se compara.

{
  "external_consumption": {
    "hotel_reservation_id": 1001,
    "external_reference": "RST-0042",
    "room_name": "101",
    "identification_number": "123456789",
    "amount": 45000,
    "invoice_pdf_url": "https://restobar.example.com/invoices/RST-0042.pdf",
    "description": "Cena Mesa 5",
    "partner": "restobar",
    "consumed_at": "2024-03-15T20:30:00Z"
  }
}