Ventas

    Un documento de venta acredita una transacción de forma legal entre dos partes.

    En esta sección aprenderás cómo utilizar la API para insertar documentos de venta en contabilidad.

    Flujo de inserción de una venta

    Hubspot - nubox (11)

    Insertando una venta

    Para insertar una venta utilizaremos el verbo http POST, puedes insertar documentos de ventas como facturas, facturas electrónicas, boletas, etc.

    exclamacion

    API endpoint exclusivo para partners, requieres de un partner key para utilizarlo

    URL del recurso

    Información del recurso

    Formato de respuesta JSON
    ¿Requiere autenticación? SI
    ¿Requiere token? SI
    ¿Requiere Partner key? SI

    Parámetros

    Nombre Descripción Tipo del parámetro Tipo del dato
    Venta Representa un documento de venta en formato JSON. Body Json
    PartnerKey Llave que identifica al partner como único. Header String

    JSON de Ventas

    En el parámetro Ventas debes incluir un JSON con la siguiente estructura.

    Nombre Tipo Obligatorio Descripción
    NumeroSerie Integer SI Número de serie del sistema, este valor se obtiene desde el resultado de la autenticación API
    Rut String SI Rut de la empresa que realiza la venta.
    Folio Integer SI Número de folio corresponde al número identificador de la venta,
    CodigoTipoDocumento Integer SI Código SII que identifica el tipo Documento
    FechaEmision String SI Fecha de emisión del documento
    MontoNeto Integer SI Monto neto del documento.
    MontoExento Integer SI Monto exento del documento.
    MontoIva Integer SI Monto IVA del documento.
    MontoTotal Integer SI Monto total del documento.
    Contraparte JSON SI Contraparte de venta
    Referencia JSON NO Referencia de venta
    ImpuestosAdicionales Array NO Otros impuestos aplicados a la venta.

    JSON de Contraparte de venta

    En el parámetro contraparte debes incluir un JSON con la siguiente estructura

    Nombre Tipo Obligatorio Descripción
    Rut String SI Rol único tributario o código de identificación tributaria del cliente.
    RazonSocial String SI Corresponde a la Razón social del cliente.
    Giro String NO Corresponde al Giro del cliente.
    ComunaId Integer SI Comuna de residencia del cliente, valores posibles se obtienen del método ObtenerComunas de la API.
    Direccion String NO Dirección de la contraparte o cliente
    Email String NO Email de la contraparte o cliente

    JSON de Referencia de venta

    En el parámetro referencia debes incluir un JSON con la siguiente estructura.

    Nombre Tipo Obligatorio Descripción
    Folio Integer NO Número de folio corresponde al número identificador de la referencia.
    CodigoTipoDocumento Integer NO Código SII que identifica el tipo Documento de la referencia de la venta

    JSON de Impuestos adicionales

    En el parámetro impuestos adicionales debes incluir un array JSON con la siguiente estructura

    Nombre Tipo Obligatorio Descripción
    CodigoTipoDeImpuesto Integer NO Código que identifica un impuesto o retención adicional.
    Monto Integer NO Monto de impuesto o retención adicional.

    Consideraciones

    exclamacion

    Revisa aquí las validaciones básicas que debes tener en consideración

    Existen algunos tipos de documentos que no son soportados, son los siguientes:

    Ejemplos de Request

    Ejemplo Response

    Response Body

    N/A

    Response Header

    Nombre Valor
    cache-control no-cache
    content-length 0
    content-type application/json; charset=utf-8
    date Thu, 16 Apr 2020 22:53:54 GMT

    Pruebas

    Probar en Swagger