Contrato canónico
- Campos requeridos por tipo documental.
- Moneda y exchange_rate cuando no es PYG.
- Comprador, vendedor, items, impuestos y totales.
Validación SIFEN v150
Validá payloads SIFEN v150 antes de emitir
La integración fiscal falla menos cuando los errores de contrato, configuración y reglas canónicas aparecen antes de enviar documentos reales al canal fiscal.
Qué se valida
La prevalidación no sustituye la respuesta final del canal, pero reduce rechazos evitables y aclara qué debe corregir negocio, contabilidad o desarrollo.
Readiness fiscal
- Empresa, sucursal y punto configurados.
- Canal fiscal disponible.
- Timbrado, numeración y certificado revisados antes del go-live.
Errores comunes
- validation_error para datos incompletos.
- configuration_error para setup faltante.
- certificate_error para material fiscal vencido o ausente.
Flujo recomendado
- POST /v1/documents/validate.
- Corregir payload y configuración.
- Recién después crear el documento con Idempotency-Key.