Validaciones básicas

    Existen reglas de negocio que debes implementar en tu código para que un documento sea capaz de entrar en la contabilidad sin problemas.

    Ejemplo de un Request que genera una validación

    Response Header

    Status code 400
    Descripción BAD REQUEST

    Response Body

    Validaciones por campo

    Las validaciones del negocio son importantes para mantener un óptimo funcionamiento del sistema, te aconsejamos anticiparte y conocer de fondo como validar tus campos, a continuación se describen las validaciones del API Endpoint de compras campo por campo.

    Validaciones de compras

     

    Rut

    Rut de la empresa que realiza la venta

    • Este campo no puede estar vacío: El Rut es un campo obligatorio.
    • Rut invalido: El Rut debe seguir el formato 12345678-9.
     

    Razón Social

    La razón social es el nombre con el que se va a conocer la empresa (jurídicamente).

    • Este campo no puede estar vacío.
    • Supera el largo permitido: el largo permitido para la razón social de una contraparte es de 100 caracteres.
     

    Tipo de documento

    Código del tipo de documento declarado por el SII
    • Los tipos de documentos soportados, son los siguientes:
    Descripción Código del SII
    Factura de inicio 29
    Factura 30
    Factura exenta 32
    Factura electrónica 33
    Factura exenta 32
    Factura electrónica exenta 34
    Factura exenta 32
    Liquidación factura 40
    Liquidación factura electrónica 43
    Factura de compra 45
    Factura de compra electrónica 46
    Nota de débito 55
    Nota de débito electrónica 56
    Nota de crédito 60
    Nota de crédito electrónica 61
    Solicitud de registro de factura 108
    Declaración de Ingreso 914
     

    Folio

    El folio corresponde al número identificador de la venta, validaciones:

    • Este campo no puede estar vacío.
    • Supera el largo permitido: El largo permitido es de 10 caracteres.
    • Documento ya existe: El de folio es único por tipo de documento y receptor.
    • El rango (o parte del rango) ya existe: a nivel de integración las documentos de tipo boleta se agrupan con el fin de no tener una cantidad enorme de documentos en la contabilidad, si tienes esta respuesta de la API entonces el documento que estas intentando insertar ya existe.
     

    Fecha de emisión

    Es la fecha en la que se expide una factura. La fecha no siempre tiene que coincidir con la fecha de operaciones.

    Considera estas validaciones de formato o negocio:

    • Este campo no puede estar vacío: la fecha de emisión es un campo obligatorio para saber cuando el SII hizo legal este documento.
    • El formato de la fecha es invalido: Las fechas deben ser manejadas en el formato yyyy-MM-dd.
    • La fecha de emisión se encuentra fuera del rango permitido: el rango permitido es entre el 01/01/1900 y  el 01/01/2100.
    • No puedes ingresar un documento menor a 6 años al actual.
     

    Fecha de vencimiento

    Es la fecha en la que se expide una factura. La fecha no siempre tiene que coincidir con la fecha de operaciones.

    Considera estas validaciones de formato o negocio:

    • El formato de la fecha es invalido: Las fechas deben ser manejadas en el formato yyyy-MM-dd.
    • La fecha de emisión se encuentra fuera del rango permitido: el rango permitido es entre el 01/01/1900 y  el 01/01/2100.
    • La fecha de vencimiento no puede ser menor a la fecha de emisión
     

    Rut emisor

    Corresponde al rut del emisor del documento

    • Rut invalido: El Rut debe seguir el formato 12345678-9.

     

    Monto exento

    El valor exento se utiliza cuando el documento es una compra o venta de un bien o servicio.

    • Este campo no puede estar vacío: Cuando el documento es exento este campo se transforma en obligatorio.
    • Si el documento es tipo afecto no puede tener montos exentos: si el documento es de tipo afecto este campo debe estar en 0.
    • Este campo debe estar vació: Cuando el documento es afecto no es necesario ingresar este campo
    • Supera el largo permitido: El valor máximo permitido es de 11 dígitos.
     

    Monto neto

    El valor neto es la base imponible sobre la cual se aplica un impuesto

    • Este campo no puede estar vacío: Cuando el documento es afecto este campo se transforma en obligatorio debido a que es el campo imponible donde se aplican los impuestos.
    • Si el documento es tipo exento no puede tener montos afectos: si el documento es de tipo exento este campo debe estar en 0.
    • Supera el largo permitido: El valor máximo permitido es de 11 dígitos.
     

    Monto Iva

    Este impuesto consiste en el recargo del 19% al monto del precio final determinado por el vendedor de un bien o servicio.

    • El monto total debe ser mayor a 0, excepto los documentos tipos notas de crédito.
    • El campo debe estar vació: cuando un documento es exento no es necesario llenar el campo IVA.
    • Supera el largo permitido: El valor máximo permitido es de 11 dígitos.

     

     

    Monto Total

    Es el resultado final del documento.

    • Monto total no puede estar vacío.
    • El monto total debe ser mayor a 0, excepto los documentos tipos notas de crédito.
    • El monto total supera el largo permitido: el largo permitido para el valor total es de 11 dígitos.
    • El monto total no cuadra: el monto total se compara contra la suma de los detalles más el impuesto menos las retenciones.

     

     

    Periodo

    Periodo es el més donde se emitido el documento

    • Periodo invalido: Periodo debe estar entre 1 y 12.
    • El periodo no puede ser menor a la fecha de emisión.
    • El periodo puede ser mayor máximo un periodo en el futuro: El periodo solo puede ser mayor hasta 3 meses de la fecha de emisión.
     

    Año

    Periodo es el número del mes donde se emitido el documento

    • Año no puede estar vacío.
    • Año inválido no puede ser menor a 6 años al actual

    Validaciones de referencias

     

    Folio

    Folio del documento que se esta referenciando

    • Supera el largo permitido: el largo permitido para el folio es de 10 dígitos.
    • No existe el documento referenciado: el documento debe existir para poder referenciarlo, los campos para comparar los documentos son el tipo de documento + el folio, si estas recibiendo este mensaje verifica que el documento exista.
     

    Tipo de documento

    Tipo del documento que se esta referenciando

    • El tipo de documento debe ser válido: Las Referencias se consideraran solo cuando el documento sea de tipo nota de crédito/débito.
    • Montos afectos: Si el documento es tipo exento no puede tener montos afectos (neto)

    Otros impuestos

     

    Código impuesto

    Código del tipo de impuesto definida por el SII

    • El código de tipo de Impuesto/Retención debe ser válido: El código debe pertenecer al maestro de tipos de impuestos.
    • El documento no puede tener el mismo tipo de impuesto repetido.
     

    Monto impuesto

    Monto del impuesto o retención 

    • Supera el largo permitido: El valor máximo permitido es de 9 dígitos.
    • Monto mayor a cero: si el monto es cero se omite la inserción del registro.
    • Registro afecto: El IVA no puede ser cero si el documento tiene al menos 1 linea afecta.
    • Documentos con impuestos: Solo los documentos Factura, Factura Electrónica y sus respectivas Notas de crédito y débito, pueden tener impuestos.