Pernoctapara desarrolladores
Obtener una clave

Contabilidad y conciliación

Cómo llevarte facturas y cobros a tu ERP, a la gestoría o a una hoja de cálculo, sin exportar nada a mano cada mes.

Necesitas el permiso billing:read

Va aparte del de reservas a propósito: una integración de accesos o un motor de venta no tiene por qué ver la facturación del recinto.

Facturas del mes

curl "https://pernocta.app/api/v1/invoices?from=2026-08-01&to=2026-08-31" \
  -H "Authorization: Bearer pna_live_TU_CLAVE"

Cada fila trae reference (serie y número tal como aparece impreso, que es por lo que pregunta la gestoría) y type: F1 es factura completa y R1 rectificativa, o sea un abono. Las rectificativas llevan importes negativos: súmalas, no las descartes.

El detalle con líneas, bases e impuestos:

curl https://pernocta.app/api/v1/invoices/UUID \
  -H "Authorization: Bearer pna_live_TU_CLAVE"

La tasa turística no lleva IVA

Aparece como línea no sujeta (excludeFromRetention), fuera de la base imponible. Si la metes en la base al cuadrar, te saldrán las cuentas mal por un importe pequeño y constante que cuesta horas encontrar.

Cobros

curl "https://pernocta.app/api/v1/payments?from=2026-08-01&to=2026-08-31" \
  -H "Authorization: Bearer pna_live_TU_CLAVE"

El filtro de fechas usa cuándo entró el dinero, no cuándo se creó el cobro. Importa: en un pago online, el enlace puede generarse el día 28 y pagarse el 2 del mes siguiente. Si filtraras por la fecha de creación, ese dinero aparecería en el mes que no toca.

  • amountCents es el bruto; refundedCents, lo devuelto de ese mismo cobro.
  • provider y providerRef son la referencia de la pasarela: es el campo por el que se casa con el extracto bancario.
  • Un cobro en pendiente es un enlace generado que nadie ha pagado. No lo cuentes como ingreso.

Que llegue solo

Suscríbete a invoice.issued y a payment.received y no tendrás que sondear nada: cada factura y cada cobro llegan a tu sistema en cuanto ocurren.

Si tu servidor estuvo caído, no hace falta que nos pidas un reenvío. Lee lo que te falte y reconcilia:

curl "https://pernocta.app/api/v1/events?since=2026-08-01T00:00:00Z&event=invoice.issued,payment.received&limit=200" \
  -H "Authorization: Bearer pna_live_TU_CLAVE"

Si lo que quieres es dárselo a la gestoría

Antes de programar nada: el panel ya genera el fichero que importan A3 (SUENLACE.DAT), ContaPlus, ContaSol y Factusol, y puede mandárselo solo a la gestoría cada mes. Se configura en Ajustes › Contabilidad y se descarga desde /api/contabilidad/export con ?formato=a3|contaplus|csv y el mismo rango de fechas.

La API de abajo es para lo otro: llevarte los datos a TU sistema. Si el destino es una gestoría con un programa de contabilidad al uso, el fichero ya hecho te ahorra el trabajo entero.

Cuadrar el mes

Con estos tres, el cierre sale sin abrir el panel:

  • /invoices — lo facturado, con sus bases e IVA.
  • /payments — lo cobrado de verdad, con su referencia bancaria.
  • /occupancy — las noches vendidas, si tu canon o tu comisión se calcula sobre ocupación.

Lo facturado y lo cobrado no tienen por qué coincidir en el mismo mes, y no es un error: una señal de agosto puede facturarse en septiembre, y una estancia larga se cobra a plazos. Cuadra por reserva, no por totales del mes.