Comprobantes

Comprobantes de retención

POST /ats-retentions/issue

Emisión de una retención ATS

Operación

POST /ats-retentions/issue

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/ats-retentions/issue \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '{
    "ambiente": 1,
    "tipo_emision": 1,
    "secuencia": 14,
    "fecha_emision": "2022-01-25",
    "periodo_fiscal": "01/2022",
    "clave_acceso": "2802201501091000000000120010010000100451993736618",
    "emisor": {
        "ruc": "0910000000001",
        "obligado_contabilidad": true,
        "contribuyente_especial": "12345",
        "regimen_rimpe": "1",
        "nombre_comercial": "XYZ Corp",
        "razon_social": "XYZ Corporación S.A.",
        "direccion": "Av. Primera 234 y calle 5ta",
        "establecimiento": {
            "punto_emision": "002",
            "codigo": "001",
            "direccion": "Av. Primera 234 y calle 5ta"
        }
    },
    "info_adicional": [
        {
            "nombre": "Enviada al correo electónico",
            "descripcion": "[email protected]"
        }
    ],
    "documentos_soporte": [
        {
            "codigo_sustento": "10",
            "tipo_documento": "41",
            "numero": "002-004-000248967",
            "fecha_emision": "2022-09-25",
            "fecha_registro_contable": "2022-09-20",
            "numero_autorizacion": "2005201901",
            "tipo_pago": "01",
            "total_sin_impuestos": 84.04,
            "total": 88.34,
            "tipo_regimen_fiscal": "01",
            "pais": "AR",
            "aplica_convenio": true,
            "pago_exterior": true,
            "pago_regimen_fiscal": true,
            "impuestos": [
                {
                    "codigo": "2",
                    "codigo_porcentaje": "2",
                    "base_imponible": 18.09,
                    "tarifa": 12.00,
                    "valor": "2.17"
                }
            ],
            "retenciones": [
                {
                    "codigo": "2",
                    "codigo_porcentaje": "10",
                    "base_imponible": 2.17,
                    "tarifa": 20,
                    "valor_retenido": 0.43
                },
                {
                    "codigo": "1",
                    "codigo_porcentaje": "327",
                    "base_imponible": 18.09,
                    "tarifa": 0,
                    "valor_retenido": 0.00,
                    "dividendos": [
                        {
                            "fecha_pago": "2022-01-25",
                            "impuesto_renta": 0.21,
                            "annio_fiscal": 2022
                        }
                    ]
                }
            ],
            "pagos": [
                {
                    "tipo_pago": "20",
                    "total": 88.34
                }
            ],
            "reembolso": {
                "codigo": "41",
                "documentos": [
                    {
                        "codigo_establecimiento": "002",
                        "codigo_punto_emision": "003",
                        "fecha_emision": "2022-09-20",
                        "pais_origen_proveedor": "EC",
                        "identificacion_proveedor": "1790017478001",
                        "tipo_identificacion_proveedor": "04",
                        "numero_autorizacion": "1234567890",
                        "secuencia": 2132,
                        "tipo": "01",
                        "tipo_proveedor": "02",
                        "impuestos": [
                            {
                                "base_imponible": 300.00,
                                "codigo": "2",
                                "codigo_porcentaje": "0",
                                "tarifa": 0.00,
                                "valor": 0.00
                            }
                        ]
                    }
                ],
                "subtotal": 300.00,
                "total": 300.00,
                "total_impuestos": 0.00
            }
        }
    ],
    "tipo_sujeto_retenido": "01",
    "sujeto": {
        "email": "[email protected]",
        "identificacion": "0987654321",
        "tipo_identificacion": "05",
        "razon_social": "Juan Pérez",
        "direccion": "Calle única Numero 987",
        "telefono": "046029400"
    }
}'

Para la emisión de una retención ATS se debe enviar la información completa del comprobante en el cuerpo del requerimiento en formato JSON.

ParámetroTipoDescripción
ambienteintegerPruebas: 1.
Producción 2.
Requerido
tipo_emisionintegerEmisión normal: 1.
Emisión por indisponibilidad: 2
Requerido
secuenciainteger (min. 1 - max. 999999999 )Número de secuencia de la retención. Requerido
clave_accesostringLa clave de acceso representa un identificador único del comprobante. Si esta información no es provista, Taxo Facturación la generará.
¿Cómo generar la clave de acceso?
fecha_emisionstringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601.
periodo_fiscalstringMes y año en el siguiente formato MM/AAAA. Ejm: 12/2015 Requerido
emisoremisorInformación completa del emisor. Requerido
info_adicionalListado de objetosInformación adicional adjunta al comprobante en forma de diccionario. Ejemplo:
[{"Email": "[email protected]"}, {"Dirección": "Avenida Amazonas"}]
documentos_soporteListado de objetos tipo documentos soporteInformación. Requerido
tipo_sujeto_retenidostringVer tabla (Requerido si la identificación del sujeto retenido es Identificación del exterior)
sujetoobjeto tipo personaInformación de la persona a quién va dirigida la retención. Requerido

Respuesta

Respuesta de ejemplo

Respuesta

{
  "id": "abcdef09876123cea56784f01",
  "ambiente": 1,
  "tipo_emision": 1,
  "secuencia": 14,
  "fecha_emision": "2022-01-25",
  "periodo_fiscal": "01/2022",
  "clave_acceso": "2802201501091000000000120010010000100451993736618",
  "emisor": {
      "ruc": "0910000000001",
      "obligado_contabilidad": true,
      "contribuyente_especial": "12345",
      "regimen_rimpe": "1",
      "nombre_comercial": "XYZ Corp",
      "razon_social": "XYZ Corporación S.A.",
      "direccion": "Av. Primera 234 y calle 5ta",
      "establecimiento": {
          "punto_emision": "002",
          "codigo": "001",
          "direccion": "Av. Primera 234 y calle 5ta"
      }
  },
  "info_adicional": [
      {
          "nombre": "Enviada al correo electónico",
          "descripcion": "[email protected]"
      }
  ],
  "documentos_soporte": [
      {
          "codigo_sustento": "10",
          "tipo_documento": "41",
          "numero": "002-004-000248967",
          "fecha_emision": "2022-09-25",
          "fecha_registro_contable": "2022-09-20",
          "numero_autorizacion": "2005201901",
          "tipo_pago": "01",
          "total_sin_impuestos": 84.04,
          "total": 88.34,
          "tipo_regimen_fiscal": "01",
          "pais": "AR",
          "aplica_convenio": true,
          "pago_exterior": true,
          "pago_regimen_fiscal": true,
          "impuestos": [
              {
                  "codigo": "2",
                  "codigo_porcentaje": "2",
                  "base_imponible": 18.09,
                  "tarifa": 12.00,
                  "valor": 2.17
              }
          ],
          "retenciones": [
              {
                  "codigo": "2",
                  "codigo_porcentaje": "10",
                  "base_imponible": 2.17,
                  "tarifa": 20,
                  "valor_retenido": 0.43
              },
              {
                  "codigo": "1",
                  "codigo_porcentaje": "327",
                  "base_imponible": 18.09,
                  "tarifa": 0,
                  "valor_retenido": 0.00,
                  "dividendos": [
                      {
                          "fecha_pago": "2022-01-25",
                          "impuesto_renta": 0.21,
                          "annio_fiscal": 2022
                      }
                  ]
              }
          ],
          "pagos": [
              {
                  "tipo_pago": "20",
                  "total": 88.34
              }
          ],
          "reembolso": {
              "codigo": "41",
              "documentos": [
                  {
                      "codigo_establecimiento": "002",
                      "codigo_punto_emision": "003",
                      "fecha_emision": "2022-09-20",
                      "pais_origen_proveedor": "EC",
                      "identificacion_proveedor": "1790017478001",
                      "tipo_identificacion_proveedor": "04",
                      "numero_autorizacion": "1234567890",
                      "secuencia": 2132,
                      "tipo": "01",
                      "tipo_proveedor": "02",
                      "impuestos": [
                          {
                              "base_imponible": 300.00,
                              "codigo": "2",
                              "codigo_porcentaje": "0",
                              "tarifa": 0.00,
                              "valor": 0.00
                          }
                      ]
                  }
              ],
              "subtotal": 300.00,
              "total": 300.00,
              "total_impuestos": 0.00
          }
      }
    ],
  "tipo_sujeto_retenido": "01",
  "sujeto": {
      "email": "[email protected]",
      "identificacion": "0987654321",
      "tipo_identificacion": "05",
      "razon_social": "Juan Pérez",
      "direccion": "Calle única Numero 987",
      "telefono": "046029400"
  }
}

Retorna un objeto tipo retención ats que incluye un nuevo parámetro id, el cual identifica de manera única a la retención ats. El campo clave_acceso generado también se incluirá como parte de la respuesta.

Emisión de una retención

Operación

POST /retentions/issue

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/retentions/issue \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '{
  "ambiente":1,
  "tipo_emision":1,
  "secuencial":14,
  "fecha_emision":"2015-12-25T11:28:56.782Z",
  "periodo_fiscal":"12/2015",
  "emisor":{
    "ruc":"0910000000001",
    "obligado_contabilidad":true,
    "contribuyente_especial":"12345",
    "nombre_comercial":"XYZ Corp",
    "razon_social":"XYZ Corporación S.A.",
    "direccion":"Av. Primera 234 y calle 5ta",
    "establecimiento":{
      "punto_emision":"002",
      "codigo":"001",
      "direccion":"Av. Primera 234 y calle 5ta"
    }
  },
  "informacion_adicional":{
    "Envíada al correo electónico":"[email protected]"
  },
  "items":[
    {
      "base_imponible": 4226.4,
      "codigo": "1",
      "codigo_porcentaje": "312",
      "fecha_emision_documento_sustento": "2015-12-04T00:00:00-05:19",
      "numero_documento_sustento": "011-007-000000251",
      "porcentaje": 1.0,
      "tipo_documento_sustento": "01",
      "valor_retenido": 42.26
    }
  ]
  "sujeto":{
    "email":"[email protected]",
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "telefono":"046029400"
  }
}'

Para la emisión de una retención se debe enviar la información completa del comprobante en el cuerpo del requerimiento en formato JSON.

ParámetroTipoDescripción
secuencialinteger (min. 1 - max. 999999999 )Número de secuencia de la retención. Requerido
emisoremisorInformación completa del emisor. Requerido
fecha_emisionstringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601.
sujetoobjeto tipo personaInformación de la persona a quién va dirigida la retención. Requerido
periodo_fiscalstringMes y año en el siguiente formato MM/AAAA. Ejm: 12/2015 Requerido
ambienteintegerPruebas: 1.
Producción 2.
Requerido
itemsvector de objetos tipo impuestoListado de impuestos retenidos. Requerido
tipo_emisionintegerEmisión normal: 1.
Emisión por indisponibilidad: 2
Requerido
versionstringVersión del formato de comprobantes electrónicos de SRI. Si no se especifica, se utilizará la última revisión del formato implementada,
clave_accesostringLa clave de acceso representa un identificador único del comprobante. Si esta información no es provista, Taxo Facturación la generará.
¿Cómo generar la clave de acceso?
informacion_adicionalobjetoInformación adicional adjunta al comprobante en forma de diccionario. Ejemplo:
{"Email": "[email protected]"}

Impuesto Retenido

ParámetroTipoDescripción
base_imponiblefloatBase imponible, máximo 2 cifras decimales. Requerido
codigostringCódigo de tipo de impuesto. Requerido
codigo_porcentajestringCódigo del porcentaje a aplicar dentro del tipo de impuesto Requerido
porcentajefloatPorcentaje establecido para el impuesto
valor_retenidofloatValor retenido, multiplicación de la base imponible por el porcentaje de retención, máximo 2 cifras decimales. Requerido
fecha_emision_documento_sustentostringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601. Requerido
numero_documento_sustentostringNúmero completo del documento sobre el que se aplica la retención. Ejm: 001-002-592738007
tipo_documento_sustentostringCódigos de tipos de documentos. Requerido

Respuesta

Respuesta de ejemplo

Respuesta
{
  "id": "abcdef09876123cea56784f01",
  "clave_acceso": "2802201501091000000000120010010000100451993736618",
  "ambiente":1,
  "tipo_emision":1,
  "secuencial":14,
  "fecha_emision":"2015-12-25T11:28:56.782Z",
  "periodo_fiscal":"12/2015",
  "emisor":{
    "ruc":"0910000000001",
    "obligado_contabilidad":true,
    "contribuyente_especial":"12345",
    "nombre_comercial":"XYZ Corp",
    "razon_social":"XYZ Corporación S.A.",
    "direccion":"Av. Primera 234 y calle 5ta",
    "establecimiento":{
      "punto_emision":"002",
      "codigo":"001",
      "direccion":"Av. Primera 234 y calle 5ta"
    }
  },
  "informacion_adicional":{
    "Envíada al correo electónico":"[email protected]"
  },
  "items":[
    {
      "base_imponible": 4226.4,
      "codigo": "1",
      "codigo_porcentaje": "312",
      "fecha_emision_documento_sustento": "2015-12-04T00:00:00-05:19",
      "numero_documento_sustento": "011-007-000000251",
      "porcentaje": 1.0,
      "tipo_documento_sustento": "01",
      "valor_retenido": 42.26
    }
  ],
  "sujeto":{
    "email":"[email protected]",
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "telefono":"046029400"
  }
}

Retorna un objeto tipo retención que incluye un nuevo parámetro id, el cual identifica de manera única a la retención. El campo clave_acceso generado también se incluirá como parte de la respuesta.

Emisión de retenciones ATS a partir de XML

POST /ats-retentions/issue/xml

Requerimiento a partir de XML

Para la emisión de un comprobante de retención ATS a partir de un XML se debe enviar contenido del archivo XML como parámetro en el cuerpo del requerimiento en formato JSON. Este XML debe cumplir con la especificación del SRI.

ParámetroTipoDescripción
xmlstringContenido del archivo xml. Requerido

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/ats-retentions/issue/xml \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '<?xml version="1.0" encoding="UTF-8"?>
<comprobanteRetencion id="comprobante" version="2.0.0">
  <infoTributaria>
    <ambiente>1</ambiente>
    <tipoEmision>1</tipoEmision>
    <razonSocial>XYZ Corporación S.A.</razonSocial>
    <nombreComercial>XYZ Corp</nombreComercial>
    <ruc>0910000000001</ruc>
    <claveAcceso>2802201501091000000000120010010000100451993736618</claveAcceso>
    <codDoc>07</codDoc>
    <estab>001</estab>
    <ptoEmi>002</ptoEmi>
    <secuencia>14</secuencia>
    <dirMatriz>Av. Primera 234 y calle 5ta</dirMatriz>
  </infoTributaria>
  <infoCompRetencion>
    <fechaEmision>2022-01-25</fechaEmision>
    <dirEstablecimiento>Av. Primera 234 y calle 5ta</dirEstablecimiento>
    <contribuyenteEspecial>12345</contribuyenteEspecial>
    <obligadoContabilidad>SI</obligadoContabilidad>
    <tipoIdentificacionSujetoRetenido>05</tipoIdentificacionSujetoRetenido>
    <parteRel>SI</parteRel>
    <razonSocialSujetoRetenido>Juan Pérez</razonSocialSujetoRetenido>
    <identificacionSujetoRetenido>0987654321</identificacionSujetoRetenido>
    <periodoFiscal>01/2022</periodoFiscal>
  </infoCompRetencion>
  <docsSustento>
    <docSustento>
      <codSustento>10</codSustento>
      <codDocSustento>41</codDocSustento>
      <numDocSustento>002-004-000248967</numDocSustento>
      <fechaEmisionDocSustento>2022-01-20</fechaEmisionDocSustento>
      <fechaRegistroContable>2022-01-20</fechaRegistroContable>
      <numAutDocSustento>2005201901</numAutDocSustento>
      <pagoLocExt>01</pagoLocExt>
      <tipoRegi>00</tipoRegi>
      <paisEfecPago>593</paisEfecPago>
      <aplicConvDobTrib>NO</aplicConvDobTrib>
      <pagExtSujRetNorLeg>NO</pagExtSujRetNorLeg>
      <pagoRegFis>SI</pagoRegFis>
      <totalComprobantesReembolso>300.00</totalComprobantesReembolso>
      <totalBaseImponibleReembolso>300.00</totalBaseImponibleReembolso>
      <totalImpuestoReembolso>0.00</totalImpuestoReembolso>
      <totalSinImpuestos>84.04</totalSinImpuestos>
      <importeTotal>88.34</importeTotal>
      <tipoRegimenFiscal>01</tipoRegimenFiscal>
      <pais>AR</pais>
      <aplicaConvenio>SI</aplicaconvenio>
      <pagoExterior>SI</pagoExterior>
      <pagoRegimenFiscal>SI</pagoRegimenFiscal>
      <impuestosDocSustento>
        <impuestoDocSustento>
          <codImpuestoDocSustento>2</codImpuestoDocSustento>
          <codigoPorcentaje>6</codigoPorcentaje>
          <baseImponible>546.74</baseImponible>
          <tarifa>0.00</tarifa>
          <valorImpuesto>0.00</valorImpuesto>
        </impuestoDocSustento>
      </impuestosDocSustento>
      <retenciones>
        <retencion>
          <codigo>2</codigo>
          <codigoRetencion>10</codigoRetencion>
          <baseImponible>546.74</baseImponible>
          <porcentajeRetener>20</porcentajeRetener>
          <valorRetenido>5.46</valorRetenido>
          <dividendos>
            <fechaPagoDiv>2022-01-31</fechaPagoDiv>
            <imRentaSoc>12.21</imRentaSoc>
            <ejerFisUtDiv>2020</ejerFisUtDiv>
          </dividendos>
        </retencion>
      </retenciones>
      <reembolsos>
        <reembolsoDetalle>
          <tipoIdentificacionProveedorReembolso>04</tipoIdentificacionProveedorReembolso>
          <identificacionProveedorReembolso>1790017478001</identificacionProveedorReembolso>
          <codPaisPagoProveedorReembolso>EC</codPaisPagoProveedorReembolso>
          <tipoProveedorReembolso>02</tipoProveedorReembolso>
          <codDocReembolso>41</codDocReembolso>
          <estabDocReembolso>002</estabDocReembolso>
          <ptoEmiDocReembolso>003</ptoEmiDocReembolso>
          <secuencialDocReembolso>2132</secuencialDocReembolso>
          <fechaEmisionDocReembolso>2022-01-31</fechaEmisionDocReembolso>
          <numeroautorizacionDocReemb>1234567890</numeroautorizacionDocReemb>
          <detalleImpuestos>
            <detalleImpuesto>
              <codigo>2</codigo>
              <codigoPorcentaje>0</codigoPorcentaje>
              <tarifa>0.00</tarifa>
              <baseImponibleReembolso>300.00</baseImponibleReembolso>
              <impuestoReembolso>0.00</impuestoReembolso>
            </detalleImpuesto>
          </detalleImpuestos>
        </reembolsoDetalle>
      </reembolsos>
      <Pagos>
        <Pago>
          <formaPago>20</formaPago>
          <total>541.27</total>
        </Pago>
      </Pagos>
    </docSustento>
  </docsSustento>
  <tipoSujetoRetenido>01</tipoSujetoRetenido>
  <infoAdicional>
    <campoAdicional nombre="nombre">Enviada al correo electónico</campoAdicional>
    <campoAdicional nombre="descripcion">[email protected]</campoAdicional>
  </infoAdicional>
</comprobanteRetencion>

Respuesta de ejemplo

Respuesta
{
  "id": "abcdef09876123cea56784f01",
  "ambiente": 1,
  "tipo_emision": 1,
  "secuencia": 14,
  "fecha_emision": "2022-01-25",
  "periodo_fiscal": "01/2022",
  "clave_acceso": "2802201501091000000000120010010000100451993736618",
  "emisor": {
      "ruc": "0910000000001",
      "obligado_contabilidad": true,
      "contribuyente_especial": "12345",
      "regimen_rimpe": "1",
      "nombre_comercial": "XYZ Corp",
      "razon_social": "XYZ Corporación S.A.",
      "direccion": "Av. Primera 234 y calle 5ta",
      "establecimiento": {
          "punto_emision": "002",
          "codigo": "001",
          "direccion": "Av. Primera 234 y calle 5ta"
      }
  },
  "info_adicional": [
      {
          "nombre": "Enviada al correo electónico",
          "descripcion": "[email protected]"
      }
  ],
  "documentos_soporte": [
      {
          "codigo_sustento": "10",
          "tipo_documento": "41",
          "numero": "002-004-000248967",
          "fecha_emision": "2022-09-25",
          "fecha_registro_contable": "2022-09-20",
          "numero_autorizacion": "2005201901",
          "tipo_pago": "01",
          "total_sin_impuestos": 84.04,
          "total": 88.34,
          "tipo_regimen_fiscal": "01",
          "pais": "AR",
          "aplica_convenio": true,
          "pago_exterior": true,
          "pago_regimen_fiscal": true,
          "impuestos": [
              {
                  "codigo": "2",
                  "codigo_porcentaje": "2",
                  "base_imponible": 18.09,
                  "tarifa": 12.00,
                  "valor": 2.17
              }
          ],
          "retenciones": [
              {
                  "codigo": "2",
                  "codigo_porcentaje": "10",
                  "base_imponible": 2.17,
                  "tarifa": 20,
                  "valor_retenido": 0.43
              },
              {
                  "codigo": "1",
                  "codigo_porcentaje": "327",
                  "base_imponible": 18.09,
                  "tarifa": 0,
                  "valor_retenido": 0.00,
                  "dividendos": [
                      {
                          "fecha_pago": "2022-01-25",
                          "impuesto_renta": 0.21,
                          "annio_fiscal": 2022
                      }
                  ]
              }
          ],
          "pagos": [
              {
                  "tipo_pago": "20",
                  "total": 88.34
              }
          ],
          "reembolso": {
              "codigo": "41",
              "documentos": [
                  {
                      "codigo_establecimiento": "002",
                      "codigo_punto_emision": "003",
                      "fecha_emision": "2022-09-20",
                      "pais_origen_proveedor": "EC",
                      "identificacion_proveedor": "1790017478001",
                      "tipo_identificacion_proveedor": "04",
                      "numero_autorizacion": "1234567890",
                      "secuencia": 2132,
                      "tipo": "01",
                      "tipo_proveedor": "02",
                      "impuestos": [
                          {
                              "base_imponible": 300.00,
                              "codigo": "2",
                              "codigo_porcentaje": "0",
                              "tarifa": 0.00,
                              "valor": 0.00
                          }
                      ]
                  }
              ],
              "subtotal": 300.00,
              "total": 300.00,
              "total_impuestos": 0.00
          }
      }
  ],
  "tipo_sujeto_retenido": "01",
  "sujeto": {
      "email": "[email protected]",
      "identificacion": "0987654321",
      "tipo_identificacion": "05",
      "razon_social": "Juan Pérez",
      "direccion": "Calle única Numero 987",
      "telefono": "046029400"
  }
}

Emisión de retenciones a partir de XML

POST /retentions/issue/xml

Requerimiento a partir de XML

Para la emisión de un comprobante de retención a partir de un XML se debe enviar contenido del archivo XML como parámetro en el cuerpo del requerimiento en formato JSON. Este XML debe cumplir con la especificación del SRI.

ParámetroTipoDescripción
xmlstringContenido del archivo xml. Requerido

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/retentions/issue/xml \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '{"xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<comprobanteRetencion id=\"comprobante\" version=\"1.0.0\">
  <infoTributaria>
    <ambiente>1</ambiente>
    <tipoEmision>1</tipoEmision>
    <razonSocial>TAXO S.A.</razonSocial>
    <nombreComercial>Taxo</nombreComercial>
    <ruc>1234567890001</ruc>
    <claveAcceso>0405202007123456789000110010010000000012235571911</claveAcceso>
    <codDoc>07</codDoc>
    <estab>001</estab>
    <ptoEmi>001</ptoEmi>
    <secuencial>000000001</secuencial>
    <dirMatriz>Innvernadero Coworking, Bálsamos 813 entre Guayacanes e Higueras</dirMatriz>
  </infoTributaria>
  <infoCompRetencion>
    <fechaEmision>04/05/2020</fechaEmision>
    <dirEstablecimiento>Innvernadero Coworking, Bálsamos 813 entre Guayacanes e Higueras</dirEstablecimiento>
    <obligadoContabilidad>NO</obligadoContabilidad>
    <tipoIdentificacionSujetoRetenido>04</tipoIdentificacionSujetoRetenido>
    <razonSocialSujetoRetenido>Juan Perez</razonSocialSujetoRetenido>
    <identificacionSujetoRetenido>0953239092001</identificacionSujetoRetenido>
    <periodoFiscal>05/2020</periodoFiscal>
  </infoCompRetencion>
  <impuestos>
    <impuesto>
      <codigo>1</codigo>
      <codigoRetencion>401CD</codigoRetencion>
      <baseImponible>10.00</baseImponible>
      <porcentajeRetener>0.00</porcentajeRetener>
      <valorRetenido>0.00</valorRetenido>
      <codDocSustento>01</codDocSustento>
      <numDocSustento>001001000000001</numDocSustento>
      <fechaEmisionDocSustento>03/05/2020</fechaEmisionDocSustento>
    </impuesto>
  </impuestos>
  <infoAdicional>
    <campoAdicional nombre="Campo adicional">Información adicional</campoAdicional>
  </infoAdicional>
</comprobanteRetencion>"}'

#### Respuesta de ejemplo

{
    "secuencial": "000000001",
    "fecha_emision": "2020-05-04T00:00:00-05:19",
    "emisor": {
        "ruc": "1234567890001",
        "razon_social": "TAXO S.A.",
        "nombre_comercial": "Taxo",
        "contribuyente_especial": "",
        "direccion": "Innvernadero Coworking, Bálsamos 813 entre Guayacanes e Higueras",
        "obligado_contabilidad": "NO",
        "establecimiento": {
            "punto_emision": "001",
            "codigo": "001",
            "direccion": "Innvernadero Coworking, Bálsamos 813 entre Guayacanes e Higueras"
        },
        "email": "[email protected]"
    },
    "sujeto": {
        "identificacion": "0953239092001",
        "razon_social": "Juan Perez",
        "tipo_identificacion": "04"
    },
    "es_valida": true,
    "periodo_fiscal": "05/2020",
    "id": "41f5188e0256420cbe9e447db99c9753",
    "informacion_adicional": {
        "Campo adicional": "Información adicional"
    },
    "ambiente": "1",
    "tipo_emision": 1,
    "items": [
        {
            "porcentaje": 0.0,
            "codigo_porcentaje": "401CD",
            "fecha_emision_documento_sustento": "2020-05-03T00:00:00-05:19",
            "numero_documento_sustento": "001-001-000000001",
            "codigo": "1",
            "tipo_documento_sustento": "01",
            "base_imponible": 10.0,
            "valor_retenido": 0.0
        }
    ],
    "clave_acceso": "0405202007123456789000110010010000000012235571911"
}

Consulta de un Comprobante de Retención ATS

Consulta una retención ats para obtener toda la información del comprobante, incluyendo el estado del mismo. El parámetro estado de la respuesta obtenida al invocar esta operación, indica el estado actual del comprobante.

Si es necesario conocer en detalle, en que estado del proceso de emisión, se debe examinar los parámetros envio_sri y autorizacion_sri de la respuesta.

Operación

GET /ats-retentions/<receipt-id>

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/ats-retentions/<id-retencion> \
-H "Content-Type: application/json" \
-H "X-Key: <clave-del-api>" \
-H "X-Password: <clave-certificado-firma>" \

Reemplaza en la ruta <receipt-id> por el id de la retención que necesitas consultar.

Respuesta

Respuesta de ejemplo

Respuesta

{
  "id": "abcdef09876123cea56784f01",
  "ambiente": 1,
  "tipo_emision": 1,
  "secuencia": 14,
  "fecha_emision": "2022-01-25",
  "periodo_fiscal": "01/2022",
  "clave_acceso": "2802201501091000000000120010010000100451993736618",
  "emisor": {
    "ruc": "0910000000001",
    "obligado_contabilidad": true,
    "contribuyente_especial": "12345",
    "regimen_rimpe": "1",
    "nombre_comercial": "XYZ Corp",
    "razon_social": "XYZ Corporación S.A.",
    "direccion": "Av. Primera 234 y calle 5ta",
    "establecimiento": {
      "punto_emision": "002",
      "codigo": "001",
      "direccion": "Av. Primera 234 y calle 5ta"
    }
  },
  "estado": "AUTORIZADO",
  "info_adicional": [
    {
      "nombre": "Enviada al correo electónico",
      "descripcion": "[email protected]"
    }
  ],
  "correos_enviados": [
    {
      "fecha_envio": "2015-05-15T16:36:48.274604",
      "destinatarios": "[email protected]"
    }
  ],
  "envio_sri": {
    "mensajes": [],
    "estado": "RECIBIDA",
    "fecha": ""
  },
  "documentos_soporte": [
      {
          "codigo_sustento": "10",
          "tipo_documento": "41",
          "numero": "002-004-000248967",
          "fecha_emision": "2022-09-25",
          "fecha_registro_contable": "2022-09-20",
          "numero_autorizacion": "2005201901",
          "tipo_pago": "01",
          "total_sin_impuestos": 84.04,
          "total": 88.34,
          "tipo_regimen_fiscal": "01",
          "pais": "AR",
          "aplica_convenio": true,
          "pago_exterior": true,
          "pago_regimen_fiscal": true,
          "impuestos": [
              {
                  "codigo": "2",
                  "codigo_porcentaje": "2",
                  "base_imponible": 18.09,
                  "tarifa": 12.00,
                  "valor": 2.17
              }
          ],
          "retenciones": [
              {
                  "codigo": "2",
                  "codigo_porcentaje": "10",
                  "base_imponible": 2.17,
                  "tarifa": 20,
                  "valor_retenido": 0.43
              },
              {
                  "codigo": "1",
                  "codigo_porcentaje": "327",
                  "base_imponible": 18.09,
                  "tarifa": 0,
                  "valor_retenido": 0.00,
                  "dividendos": [
                      {
                          "fecha_pago": "2022-01-25",
                          "impuesto_renta": 0.21,
                          "annio_fiscal": 2022
                      }
                  ]
              }
          ],
          "pagos": [
              {
                  "tipo_pago": "20",
                  "total": 88.34
              }
          ],
          "reembolso": {
              "codigo": "41",
              "documentos": [
                  {
                      "codigo_establecimiento": "002",
                      "codigo_punto_emision": "003",
                      "fecha_emision": "2022-09-20",
                      "pais_origen_proveedor": "EC",
                      "identificacion_proveedor": "1790017478001",
                      "tipo_identificacion_proveedor": "04",
                      "numero_autorizacion": "1234567890",
                      "secuencia": 2132,
                      "tipo": "01",
                      "tipo_proveedor": "02",
                      "impuestos": [
                          {
                              "base_imponible": 300.00,
                              "codigo": "2",
                              "codigo_porcentaje": "0",
                              "tarifa": 0.00,
                              "valor": 0.00
                          }
                      ]
                  }
              ],
              "subtotal": 300.00,
              "total": 300.00,
              "total_impuestos": 0.00
          }
      }
  ],
  "tipo_sujeto_retenido": "01",
  "sujeto": {
    "email": "[email protected]",
    "identificacion": "0987654321",
    "tipo_identificacion": "05",
    "razon_social": "Juan Pérez",
    "direccion": "Calle única Numero 987",
    "telefono": "046029400"
  },
  "autorizacion": {
    "estado": "AUTORIZADO",
    "mensajes": [
      {
        "identificador": "60",
        "mensaje": "ESTE PROCESO FUE REALIZADO EN EL AMBIENTE DE PRUEBAS",
        "tipo": "INFORMATIVO",
        "informacion_adicional": ""
      }
    ],
    "numero": "1505201516323509927125540010266935227",
    "fecha": "2015-05-15T16:32:35.000380"
  }
}
ParámetroTipoDescripción
ambienteintegerPruebas: 1.
Producción 2.
estadostringPosibles valores: AUTORIZADO, NO AUTORIZADO, ENVIADO, DEVUELTO, RECIBIDO, ERROR
tipo_emisionintegerEmisión normal: 1.
Emisión por indisponibilidad: 2
secuenciainteger (min. 1 - max. 999999999 )Número de secuencia de la retención.
clave_accesostringLa clave de acceso representa un identificador único del comprobante. Si esta información no es provista, Taxo Facturación la generará.
¿Cómo generar la clave de acceso?
fecha_emisionstringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601.
periodo_fiscalstringMes y año en el siguiente formato MM/AAAA. Ejm: 12/2015
envio_sriobjeto tipo envio sriInformación luego de enviar el comprobante.
autorizacionobjeto tipo autorizacion sriInformación de la autorización.org/html/rfc3339#section-5.6).
emisoremisorInformación completa del emisor.
info_adicionalListado de objetosInformación adicional adjunta al comprobante en forma de diccionario. Ejemplo:
[{"Email": "[email protected]"}, {"Dirección": "Avenida Amazonas"}]
documentos_soporteListado de objetos tipo documentos soporteInformación.
sujetoobjeto tipo personaInformación de la persona a quién va dirigida la retención.

Re-emisión de una retención ATS

Operación

POST /retentions/:id/reissue

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/ats-retentions/<id-retencion-ats>/reissue \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '{
    "ambiente": 1,
    "tipo_emision": 1,
    "secuencia": 14,
    "fecha_emision": "2022-01-25",
    "periodo_fiscal": "01/2022",
    "clave_acceso": "2802201501091000000000120010010000100451993736618",
    "emisor": {
        "ruc": "0910000000001",
        "obligado_contabilidad": true,
        "contribuyente_especial": "12345",
        "regimen_rimpe": "1",
        "nombre_comercial": "XYZ Corp",
        "razon_social": "XYZ Corporación S.A.",
        "direccion": "Av. Primera 234 y calle 5ta",
        "establecimiento": {
            "punto_emision": "002",
            "codigo": "001",
            "direccion": "Av. Primera 234 y calle 5ta"
        }
    },
    "info_adicional": [
        {
            "nombre": "Enviada al correo electónico",
            "descripcion": "[email protected]"
        }
    ],
    "documentos_soporte": [
        {
            "codigo_sustento": "10",
            "tipo_documento": "41",
            "numero": "002-004-000248967",
            "fecha_emision": "2022-09-25",
            "fecha_registro_contable": "2022-09-20",
            "numero_autorizacion": "2005201901",
            "tipo_pago": "01",
            "total_sin_impuestos": 84.04,
            "total": 88.34,
            "tipo_regimen_fiscal": "01",
            "pais": "AR",
            "aplica_convenio": true,
            "pago_exterior": true,
            "pago_regimen_fiscal": true,
            "impuestos": [
                {
                    "codigo": "2",
                    "codigo_porcentaje": "2",
                    "base_imponible": 18.09,
                    "tarifa": 12.00,
                    "valor": 2.17
                }
            ],
            "retenciones": [
                {
                    "codigo": "2",
                    "codigo_porcentaje": "10",
                    "base_imponible": 2.17,
                    "tarifa": 20,
                    "valor_retenido": 0.43
                },
                {
                    "codigo": "1",
                    "codigo_porcentaje": "327",
                    "base_imponible": 18.09,
                    "tarifa": 0,
                    "valor_retenido": 0.00,
                    "dividendos": [
                        {
                            "fecha_pago": "2022-01-25",
                            "impuesto_renta": 0.21,
                            "annio_fiscal": 2022
                        }
                    ]
                }
            ],
            "pagos": [
                {
                    "tipo_pago": "20",
                    "total": 88.34
                }
            ],
            "reembolso": {
                "codigo": "41",
                "documentos": [
                    {
                        "codigo_establecimiento": "002",
                        "codigo_punto_emision": "003",
                        "fecha_emision": "2022-09-20",
                        "pais_origen_proveedor": "EC",
                        "identificacion_proveedor": "1790017478001",
                        "tipo_identificacion_proveedor": "04",
                        "numero_autorizacion": "1234567890",
                        "secuencia": 2132,
                        "tipo": "01",
                        "tipo_proveedor": "02",
                        "impuestos": [
                            {
                                "base_imponible": 300.00,
                                "codigo": "2",
                                "codigo_porcentaje": "0",
                                "tarifa": 0.00,
                                "valor": 0.00
                            }
                        ]
                    }
                ],
                "subtotal": 300.00,
                "total": 300.00,
                "total_impuestos": 0.00
            }
        }
    ],
    "tipo_sujeto_retenido": "01",
    "sujeto": {
        "email": "[email protected]",
        "identificacion": "0987654321",
        "tipo_identificacion": "05",
        "razon_social": "Juan Pérez",
        "direccion": "Calle única Numero 987",
        "telefono": "046029400"
    }
}'

Esta operación debe ser utilizada para corregir comprobantes NO AUTORIZADOS o DEVUELTOS por el Servicio de Rentas Internas.

En la URL de esta opción se debe incluir el id de la retención ATS recibida al momento de emitirla.

El cuerpo del requerimiento es un objeto retención ATS con los datos corregidos para que pueda ser procesado y autorizado.

Respuesta

Respuesta de ejemplo

Respuesta

{
  "id": "abcdef09876123cea56784f01",
  "ambiente": 1,
  "tipo_emision": 1,
  "secuencia": 14,
  "fecha_emision": "2022-01-25",
  "periodo_fiscal": "01/2022",
  "clave_acceso": "2802201501091000000000120010010000100451993736618",
  "emisor": {
      "ruc": "0910000000001",
      "obligado_contabilidad": true,
      "contribuyente_especial": "12345",
      "regimen_rimpe": "1",
      "nombre_comercial": "XYZ Corp",
      "razon_social": "XYZ Corporación S.A.",
      "direccion": "Av. Primera 234 y calle 5ta",
      "establecimiento": {
          "punto_emision": "002",
          "codigo": "001",
          "direccion": "Av. Primera 234 y calle 5ta"
      }
  },
  "info_adicional": [
      {
          "nombre": "Enviada al correo electónico",
          "descripcion": "[email protected]"
      }
  ],
  "documentos_soporte": [
      {
          "codigo_sustento": "10",
          "tipo_documento": "41",
          "numero": "002-004-000248967",
          "fecha_emision": "2022-09-25",
          "fecha_registro_contable": "2022-09-20",
          "numero_autorizacion": "2005201901",
          "tipo_pago": "01",
          "total_sin_impuestos": 84.04,
          "total": 88.34,
          "tipo_regimen_fiscal": "01",
          "pais": "AR",
          "aplica_convenio": true,
          "pago_exterior": true,
          "pago_regimen_fiscal": true,
          "impuestos": [
              {
                  "codigo": "2",
                  "codigo_porcentaje": "2",
                  "base_imponible": 18.09,
                  "tarifa": 12.00,
                  "valor": 2.17
              }
          ],
          "retenciones": [
              {
                  "codigo": "2",
                  "codigo_porcentaje": "10",
                  "base_imponible": 2.17,
                  "tarifa": 20,
                  "valor_retenido": 0.43
              },
              {
                  "codigo": "1",
                  "codigo_porcentaje": "327",
                  "base_imponible": 18.09,
                  "tarifa": 0,
                  "valor_retenido": 0.00,
                  "dividendos": [
                      {
                          "fecha_pago": "2022-01-25",
                          "impuesto_renta": 0.21,
                          "annio_fiscal": 2022
                      }
                  ]
              }
          ],
          "pagos": [
              {
                  "tipo_pago": "20",
                  "total": 88.34
              }
          ],
          "reembolso": {
              "codigo": "41",
              "documentos": [
                  {
                      "codigo_establecimiento": "002",
                      "codigo_punto_emision": "003",
                      "fecha_emision": "2022-09-20",
                      "pais_origen_proveedor": "EC",
                      "identificacion_proveedor": "1790017478001",
                      "tipo_identificacion_proveedor": "04",
                      "numero_autorizacion": "1234567890",
                      "secuencia": 2132,
                      "tipo": "01",
                      "tipo_proveedor": "02",
                      "impuestos": [
                          {
                              "base_imponible": 300.00,
                              "codigo": "2",
                              "codigo_porcentaje": "0",
                              "tarifa": 0.00,
                              "valor": 0.00
                          }
                      ]
                  }
              ],
              "subtotal": 300.00,
              "total": 300.00,
              "total_impuestos": 0.00
          }
      }
  ],
  "tipo_sujeto_retenido": "01",
  "sujeto": {
      "email": "[email protected]",
      "identificacion": "0987654321",
      "tipo_identificacion": "05",
      "razon_social": "Juan Pérez",
      "direccion": "Calle única Numero 987",
      "telefono": "046029400"
  }
}

Retorna un objeto tipo retención ATS que incluye un nuevo parámetro id, el cual identifica de manera única a la retención ATS. El campo clave_acceso generado también se incluirá como parte de la respuesta. Sí el comprobante de retención ya está autorizada se retornará un error.

Consulta de un Comprobante de Retención

Consulta una retención para obtener toda la información del comprobante, incluyendo el estado del mismo. El parámetro estado de la respuesta obtenida al invocar esta operación, indica el estado actual del comprobante.

Si es necesario conocer en detalle, en que estado del proceso de emisión, se debe examinar los parámetros envio_sri y autorizacion_sri de la respuesta.

Operación

GET /retentions/<receipt-id>

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/retentions/<id-retencion> \
-H "Content-Type: application/json" \
-H "X-Key: <clave-del-api>" \
-H "X-Password: <clave-certificado-firma>" \

Reemplaza en la ruta <receipt-id> por el id de la retención que necesitas consultar.

Respuesta

Respuesta de ejemplo

Respuesta
{
    "id": "abcf12343faad06785abcf12343faad0",
    "secuencial": "16",
    "fecha_emision": "2015-05-15",
    "version": "1.0.0",
    "clave_acceso": "1505201501099271255400110011000000000162092727615",
    "emisor": {
        "ruc": "0992712554001",
        "razon_social": "TAXO S.A.",
        "nombre_comercial": "Taxo",
        "direccion": null,
        "obligado_contabilidad": true,
        "contribuyente_especial": "",
        "establecimiento": {
            "codigo": "001",
            "direccion": "V.E. 112 Y CIRCUNVALACION NORTE",
            "punto_emision": "100"
        }
    },
    "estado": "AUTORIZADO",
    "items":[
      {
        "base_imponible": 4226.4,
        "codigo": "1",
        "codigo_porcentaje": "312",
        "fecha_emision_documento_sustento": "2015-12-04T00:00:00-05:19",
        "numero_documento_sustento": "011007000000251",
        "porcentaje": 1.0,
        "tipo_documento_sustento": "01",
        "valor_retenido": 42.26
      }
    ],
    "correos_enviados": [
        {
            "fecha_envio": "2015-05-15T16:36:48.274604",
            "destinatarios": "[email protected]"
        }
    ],
    "informacion_adicional": {},
    "ambiente": "1",
    "sujeto": {
        "razon_social": "Carlos L. Plaza",
        "identificacion": "0900102222",
        "tipo_identificacion": 1,
        "email": "[email protected]",
        "direccion": "Calle Uno y Calle Dos",
        "telefono": "043334445"
    },
    "envio_sri": {
        "mensajes": [],
        "estado": "RECIBIDA",
        "fecha": ""
    },
    "tipo_emision": "1",
    "autorizacion": {
        "estado": "AUTORIZADO",
        "mensajes": [
            {
                "identificador": "60",
                "mensaje": "ESTE PROCESO FUE REALIZADO EN EL AMBIENTE DE PRUEBAS",
                "tipo": "INFORMATIVO",
                "informacion_adicional": ""
            }
        ],
        "numero": "1505201516323509927125540010266935227",
        "fecha": "2015-05-15T16:32:35.000380"
    }
}
ParámetroTipoDescripción
secuencialstringNúmero de secuencia de la retención.
estadostringPosibles valores: AUTORIZADO, NO AUTORIZADO, ENVIADO, DEVUELTO, RECIBIDO, ERROR
fecha_emisionstringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar [ISO8601](http://tools.ietf.
clave_accesostringLa clave de acceso representa un identificador único del comprobante. Si esta información no es provista, Taxo Facturación la generará.
¿Cómo generar la clave de acceso?
envio_sriobjeto tipo envio sriInformación luego de enviar el comprobante.
autorizacionobjeto tipo autorizacion sriInformación de la autorización.org/html/rfc3339#section-5.6).
emisorobjeto tipo emisorInformación completa del emisor.
ambienteintegerPruebas: 1.
Producción 2.
itemsvector de objetos tipo impuestoListado de impuestos retenidos. Requerido
sujetoobjeto personaInformación del sujeto al que se le retiene.
tipo_emisionintegerEmisión normal: 1.
Emisión por indisponibilidad: 2
versionstringVersión de la especificación, opciones válidas: 1.0.0, 1.1.0

Re-emisión de una retención

Operación

POST /retentions/:id/reissue

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/retentions/<id-retencion>/reissue \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '{
  "ambiente":1,
  "tipo_emision":1,
  "secuencial":14,
  "fecha_emision":"2015-12-25T11:28:56.782Z",
  "periodo_fiscal":"12/2015",
  "emisor":{
    "ruc":"0910000000001",
    "obligado_contabilidad":true,
    "contribuyente_especial":"12345",
    "nombre_comercial":"XYZ Corp",
    "razon_social":"XYZ Corporación S.A.",
    "direccion":"Av. Primera 234 y calle 5ta",
    "establecimiento":{
      "punto_emision":"002",
      "codigo":"001",
      "direccion":"Av. Primera 234 y calle 5ta"
    }
  },
  "informacion_adicional":{
    "Envíada al correo electónico":"[email protected]"
  },
  "items":[
    {
      "base_imponible": 4226.4,
      "codigo": 1,
      "codigo_porcentaje": "312",
      "fecha_emision_documento_sustento": "2015-12-04T00:00:00-05:19",
      "numero_documento_sustento": "011-007-000000251",
      "porcentaje": 1.0,
      "tipo_documento_sustento": "01",
      "valor_retenido": 42.26
    }
  ]
  "sujeto":{
    "email":"[email protected]",
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "telefono":"046029400"
  }
}'

Esta operación debe ser utilizada para corregir comprobantes NO AUTORIZADOS o DEVUELTOS por el Servicio de Rentas Internas.

En la URL de esta opción se debe incluir el id de la retención recibida al momento de emitirla.

El cuerpo del requerimiento es un objeto retención con los datos corregidos para que pueda ser procesado y autorizado.

Respuesta

Respuesta de ejemplo

Respuesta
{
  "id": "abcdef09876123cea56784f01",
  "ambiente":1,
  "tipo_emision":1,
  "secuencial":148,
  "fecha_emision":"2015-02-28T11:28:56.782Z",
  "clave_acceso": "2802201501091000000000120010010000100451993736618",
  "emisor":{
    "ruc": "0910000000001",
    "obligado_contabilidad": true,
    "contribuyente_especial": "12345",
    "nombre_comercial": "XYZ Corp",
    "razon_social": "XYZ Corporación S.A.",
    "direccion": "Av. Primera 234 y calle 5ta",
    "establecimiento": {
      "punto_emision": "002",
      "codigo": "001",
      "direccion": "Av. Primera 234 y calle 5ta"
    }
  },
  "moneda": "USD",
  "informacion_adicional": {
    "Tiempo de entrega": "5 días"
  },
  "totales": {
    "total_sin_impuestos": 120.89,
    "impuestos": [
      {
        "base_imponible": 0.0,
        "valor": 0.0,
        "codigo": "2",
        "codigo_porcentaje": "0",
        "tarifa": 0.0
      },
      {
        "base_imponible": 120.89,
        "valor": 14.51,
        "codigo": "2",
        "codigo_porcentaje": "2",
        "tarifa": 12.0
      }
    ],
    "importe_total": 135.4,
    "propina": 0.0,
    "descuento": 0.0
  },
  "comprador": {
    "email": "[email protected]",
    "identificacion": "0987654321",
    "tipo_identificacion": "05",
    "razon_social": "Juan Pérez",
    "direccion": "Calle única Numero 987",
    "telefono": "046029400"
  },
  "items":[
    {
      "cantidad": 622.0,
      "codigo_principal": "ZNC",
      "codigo_auxiliar": "050",
      "precio_unitario": 7.01,
      "descripcion": "Zanahoria granel  50 Kg.",
      "precio_total_sin_impuestos": 4360.22,
      "impuestos":[
        {
          "base_imponible": 120.89,
          "valor": 14.51,
          "tarifa": 12.0,
          "codigo": "2",
          "codigo_porcentaje": "2"
        }
      ],
      "detalles_adicionales": {
        "Peso": "5000.0000"
      },
      "descuento": 0.0
    }
  ]
}

Retorna un objeto tipo retención que incluye un nuevo parámetro id, el cual identifica de manera única a la retención. El campo clave_acceso generado también se incluirá como parte de la respuesta. Sí el comprobante de retención ya está autorizada se retornará un error.

Notas de débito

POST /debit-notes/issue

Guías de remisión

POST /waybills/issue