Referencia de Reglas de Validación

Este documento explica las reglas de validación aplicadas a las solicitudes de documentos API.

Tabla de Contenidos

• Reglas de Validación General
• Detalles Adicionales por Ítem
• Tipos de Identificación del Cliente
• Formatos de Número de Documento
• Códigos de Impuestos
• Errores Comunes y Soluciones

Reglas de Validación General

Campos Obligatorios por Tipo de Documento

#### Factura (tipo: "01")

#### Nota de Crédito (tipo: "04")

#### Retención (tipo: "07")

Detalles Adicionales por Ítem

Los documentos de tipo Factura (01) y Nota de Crédito (04) permiten enviar información adicional por cada elemento de detalles usando el campo opcional detallesAdicionales.

Estructura

{
  "detalles": [
    {
      "codigoPrincipal": "P-001",
      "descripcion": "Producto A",
      "cantidad": 1,
      "precioUnitario": 100.00,
      "descuento": 0,
      "precioTotalSinImpuesto": 100.00,
      "impuestos": [
        {
          "codigo": "2",
          "codigoPorcentaje": "4",
          "tarifa": 15,
          "baseImponible": 100.00,
          "valor": 15.00
        }
      ],
      "detallesAdicionales": [
        {
          "nombre": "Lote",
          "valor": "L-2026-0001"
        },
        {
          "nombre": "Serie",
          "valor": "SN-ABC-12345"
        }
      ]
    }
  ]
}

Reglas de validación

Notas

• Máximo 10 elementos por cada ítem de detalles.
• nombre y valor se envían como pares clave/valor.
• Si se envía detallesAdicionales, cada objeto debe contener ambos campos (nombre y valor).
• En XML se genera bajo <detallesAdicionales> con nodos <detAdicional nombre="..." valor="..."/>.

Tipos de Identificación del Cliente

Formatos de Número de Documento

Formato General

{establecimiento}-{puntoEmision}-{secuencial}

Componentes

Reglas

• El secuencial debe ser único por establecimiento y punto de emisión
• Factura y Nota de Crédito usan numeración independiente
• Retención usa numeración independiente

---

Códigos de Impuestos

IVA

IR (Retenciones)

Tabla SRI del Sistema

Errores Comunes y Soluciones

Secuencial Ya Existe

Solución: Use un nuevo número secuencial incrementando el último usado.

Totales No Cuadran

Solución: Verifique que la suma de detalles + impuestos sea igual al total enviado.

Empresa No Encontrada

Solución: Verifique que el RUC corresponda a una empresa registrada y activa en el sistema.

Cliente No Válido

Solución: Use uno de los códigos válidos: 04, 05, 06, 07, 08

Mejores Prácticas