Ventas - 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 ventas campo por campo.

Validaciones de ventas

 

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.
 

Folio

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

  • Este campo no puede estar vacío.
  • Supera el largo permitido: para boletas el largo permitido es de 20 caracteres, para los demás tipos de documentos el largo es de 10 caracteres.
  • Documento ya existe: El de folio es único por tipo de documento y emisor, excepto para los documentos de tipo boletas voucher.
  • 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.
 

Tipo de documento

Código del tipo de documento declarado por el SII
  • Los tipos de documentos soportados son:
Descripción Código del SII
Factura 30
Factura exenta 32
Factura electrónica 33
Factura electrónica exenta 34
Boleta 35
Boleta exenta 38
Boleta electrónica 39
Liquidación de factura 40
Boleta electrónica exenta 41
Liquidación de factura electrónica 43
Factura de compra 45
Factura de compra electrónica 46
Boleta Voucher 48
Nota de débito 55
Nota de débito electrónica 56
Nota de crédito 60
Nota de crédito electrónica 61
Factura de exportación 101
Liquidación 103
Nota de crédito exportación 106
Factura de exportación electrónica 110
Nota de débito exportación 111
 

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.
 

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 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 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.

 

 

Monto Total

Es el resultado final del documento.

  • 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 compra contra la suma de los detalles más el impuesto menos las retenciones.

 

Validaciones de contraparte

 

Rut

Rut de la contraparte a quien se emite el documento

  • 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.

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.

Otros impuestos y retenciones

 

Código tipo impuesto

Código del tipo de impuesto o retención 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 o retenciones.
  • Solo los documentos tipo factura, factura electrónica, boletas, boletas electrónicas y boletas voucher pueden tener impuestos, más notas de crédito/debito que referencien a estos mismos documentos.
  • El documento no puede tener el mismo tipo de impuesto.
  • Solo los documentos tipo Factura de compra, Factura de compra electrónica y sus respectivas Notas de crédito y débito, pueden tener retenciones adicionales.
 

Monto impuesto

Monto del impuesto o retención 

  • Supera el largo permitido: El valor máximo permitido es de 9 dígitos.
  • Si el documento es tipo Factura de Compras o Factura de Compra Electrónica, el monto de la Retención no puede ser 0.