Estás en: Documentación › Facturación › Obtener una factura
Obtener una factura
Parámetros que acepta este endpoint y campos que devuelve.
GET
/v1/invoices/{id}Permiso necesario en la clave: invoices:read (o *).
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Qué es | Ejemplo |
|---|---|---|---|---|
{id} | número entero | Sí | Identificador numérico del registro, el campo «id» que devuelve el listado. | 32 |
Parámetros de consulta
Este endpoint no admite filtros.
Campos de la respuesta
| Campo | Tipo | Qué contiene |
|---|---|---|
id | número entero | Identificador interno del documento. |
ref | texto | Número visible del documento. |
status | texto (lista) | draft, validated, sent, accepted, rejected, billed o cancelled. |
date | fecha AAAA-MM-DD | Fecha del documento (AAAA-MM-DD). |
validated_on | fecha AAAA-MM-DD | Fecha de validación. |
due_date | fecha AAAA-MM-DD | Vencimiento. Es null si el taller no lo informa. |
customer.id | número entero | Cliente: identificador. |
customer.code | texto | Cliente: código. |
customer.name | texto | Cliente: nombre o razón social. |
customer.tax_id | texto | Cliente: NIF / CIF. |
vehicle_id | número entero | Vehículo, si lo hay. |
work_order_id | número entero | Orden de trabajo, si la hay. |
origin_id | número entero | Documento del que procede (por ejemplo, el presupuesto). |
origin_type | texto (lista) | Tipo del documento de origen: quote, proforma o invoice. |
origin_ref | texto | Número visible del documento de origen. |
currency | texto | Moneda. |
tax_type | texto | Impuesto del taller: IVA, IGIC o IPSI. Null si no está configurado. |
total_net | número | Base imponible. |
total_tax | número | Importe del impuesto (IVA, IGIC o IPSI según tax_type). |
total_gross | número | Total con impuestos. |
discount_percent | número | Descuento en %. |
discount_amount | número | Descuento en importe. |
tax_breakdown[].rate | número | Desglose: tipo impositivo en %. |
tax_breakdown[].base | número | Desglose: base de ese tipo. |
tax_breakdown[].tax | número | Desglose: cuota de ese tipo. |
notes | texto | Observaciones públicas del documento. |
created_at | fecha y hora ISO 8601 | Alta. Fecha y hora ISO 8601 en UTC. |
updated_at | fecha y hora ISO 8601 | Última modificación. Fecha y hora ISO 8601 en UTC. |
payment_status | texto (lista) | pending, partial, paid, refund_pending o cancelled. |
amount_paid | número | Importe cobrado. |
amount_due | número | Importe pendiente de cobro. |
verifactu_status | texto | Estado del envío a la AEAT (Verifactu). Null si no aplica. |
rectification.rectifies_invoice_id | número entero | Solo en rectificativas: factura que rectifica. |
rectification.type | texto | Solo en rectificativas: tipo de rectificación. |
rectification.aeat_reason_code | texto | Solo en rectificativas: código de motivo AEAT. |
rectification.reason | texto | Solo en rectificativas: motivo. |
lines[].id | número entero | Línea: identificador. |
lines[].position | número entero | Línea: orden. |
lines[].type | texto | Línea: tipo (mano_obra, recambio…). |
lines[].description | texto | Línea: descripción. |
lines[].quantity | número | Línea: cantidad. |
lines[].unit_price | número | Línea: precio unitario sin impuestos. |
lines[].discount_percent | número | Línea: descuento en %. |
lines[].tax_rate | número | Línea: tipo impositivo en %. |
lines[].total_net | número | Línea: base. |
lines[].total_tax | número | Línea: impuesto. |
lines[].total_gross | número | Línea: total. |
lines[].product_id | número entero | Línea: producto del catálogo, si lo hay. |