Saltar al contenido
Vintu API
Tema de la documentación
Ir a la app

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:

Python
from decimal import Decimal

total = Decimal(comprobante["total"])   # nunca float(comprobante["total"])

Fechas e instantes

TipoFormatoEjemploCampos
FechaAAAA-MM-DD2026-11-09fecha_emision, fecha_vencimiento
InstanteISO 8601 con zona horaria2026-11-10T14:32:05.120000+00:00creado_en, actualizado_en, fecha_notificacion, marca_superior
PeriodoAAAA-MM2026-11periodo 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.