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.