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.