Replace a receipt with a full invoice

Provide invoiceId or orderId. Keeps the original receipt and links the new full invoice; does not overwrite the receipt.

Integration access is restricted to the credential's location. Pagination, monetary units and response envelopes are endpoint-specific; use the schema below. Do not assume that POST/PATCH requests are safe to retry after a timeout.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

«El cliente pide factura» sobre un ticket ya emitido.

No modifica el ticket: crea una factura completa nueva, con su serie, su
número y su fecha de expedición, que sustituye a la simplificada. Las dos
quedan guardadas y enlazadas.

El ticket se identifica de una de dos formas, y hacen falta las dos porque en
Kivly una simplificada puede vivir en dos sitios distintos:

  • order_id — el caso normal. La simplificada de una venta del TPV se
    declara al cerrar el pedido y su registro fiscal se guarda en el propio
    pedido
    : no hay documento en invoices hasta que alguien pide factura.
  • invoice_id — cuando la simplificada sí es un documento, como en las
    facturas de enlace de pago.

customerCompany
object
required

Datos del cliente (empresa o particular).

postal_code va aparte de address porque hay administraciones que lo piden
separado: TicketBAI tiene CodigoPostal y Direccion como dos elementos, y
en Gipuzkoa y Araba una factura con destinatario identificado y sin
dirección se rechaza
. Es opcional para no invalidar las facturas ya
emitidas; cuando falta se intenta leer de address, y si no se puede leer con
seguridad se pide, en vez de adivinarlo: un código postal inventado viaja a
la hacienda foral igual que uno correcto.

El documento a sustituir

El pedido cuya simplificada se sustituye

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json