Formatos y convenciones
Todas las respuestas son JSON en UTF-8. Estas reglas valen para todos los recursos.
Nombres
Los campos están en español y en snake_case: razon_social, fecha_emision, actualizado_en. Los valores de
dominio siguen el vocabulario de SUNAT y SUNAFIL: IGV_RENTA, PLAME, recibo_honorarios.
Identificadores
Cada recurso tiene un id UUID estable, que es el que aceptan las operaciones de detalle y el filtro empresa_id.
No uses el RUC como identificador de una empresa: puede corregirse sin que cambie su id.
Importes
Los importes son cadenas con un número decimal, punto como separador y sin separador de miles: "1180.00".
El formato admite el signo negativo ("-50.00"). Conviértelos a un tipo decimal, no a coma flotante:
from decimal import Decimal
total = Decimal(comprobante["total"]) # nunca float(comprobante["total"])Fechas e instantes
| Tipo | Formato | Ejemplo | Campos |
|---|---|---|---|
| Fecha | AAAA-MM-DD | 2026-11-09 | fecha_emision, fecha_vencimiento |
| Instante | ISO 8601 con zona horaria | 2026-11-10T14:32:05.120000+00:00 | creado_en, actualizado_en, fecha_notificacion, marca_superior |
| Periodo | AAAA-MM | 2026-11 | periodo de los vencimientos |
No supongas una zona horaria en particular en los instantes: léela del propio valor. Los que envías tú, como
actualizado_desde, también tienen que llevarla.
Nulos
Un campo que Vintu no pudo leer de un comprobante llega como null, no se omite: tipo, serie, numero,
moneda o los importes pueden ser nulos si el documento no los trae o no se pudieron extraer. Cada campo indica en
la referencia si puede serlo.
Campos nuevos
Pueden aparecer campos nuevos en las respuestas sin cambiar de versión. Ignora los que no conozcas en vez de rechazar la respuesta. Ver Versionado.