API LaFactura.co:Documents retencion ec

De API LaFactura.co
Ir a la navegación Ir a la búsqueda

Objeto:documents(Retención)

Este objeto es un arreglo, del sistema de envio de Retenciones de nuestra API, Permite enviar todos los datos referentes a los documentos objeto de rentenciones

Ejemplo de documents
           "documents":[
               {
                  "taxSupportCode":"01",
                  "documentType":"15",
                  "documentNumber":"900900900",
                  "issueDate":"20260610",
                  "paymentLocation":"02",
                  "totalWithoutTaxes":"120.00",
                  "totalAmount":"138.00",
                  "taxes":[
                         {
                            "ID":"2",
                            "code":"4",
                            "taxableAmount":"120.00",
                            "percent":"15.00",
                            "taxAmount":"18.00"
                         }
                   ],
                   "withholdings":[
                      {
                         "withholdingTaxCode":"2",
                         "withholdingCode":"3",
                         "taxableAmount":"18.00",
                         "withholdingRate":"100.00",
                         "withheldAmount":"18.00"
                       },
                       {
                         "withholdingTaxCode":"1",
                         "withholdingCode":"304A",
                         "taxableAmount":"120.00",
                         "withholdingRate":"10.00",
                         "withheldAmount":"12.00"
                       }
                   ],
                   "payments":[
                       {
                         "type":"20",
                         "total":"108.00"
                       }
                    ],
                    "foreignPayment":{
                         "regimeType":"01",
                         "paymentCountryCode":"840",
                         "doubleTaxationTreatyApplies":"false",
                         "foreignPaymentSubjectToWithholding":"true"					
                    }
                }
            ]
Explicacion

Se está solicitando la creación de un certificado de retencion a Pedro Perez (Extranjero), sin relacion con la empresa y sin obligacion a llevar contabilidad. Este comprobante se le emite para el periodo 06/2026 y su correo es [email protected]

Documento sujeto a la retencion: Este documento de sustento corresponde a una compra/pago al exterior soportado por un documento emitido en el exterior.

  • El documento sustento tiene el código de sustento tributario 01, lo que indica el tipo de soporte tributario que se está reportando para efectos del ATS/SRI.
  • El tipo de documento sustento es 15, es decir, un comprobante de venta emitido en el exterior. El número de ese documento es AA001 y fue emitido el 18 de junio de 2026.
  • El valor del documento antes de impuestos es USD 120.00. Sobre esa base se causa IVA del 15%, equivalente a USD 18.00. Por tanto, el valor total del documento es:
        120.00 + 18.00 = 138.00
  • En el bloque de impuestos del documento sustento se informa que el documento tiene IVA:
        Codigo 2: impuesto IVA.
        codigoPorcentaje 4: tarifa de IVA 15%.
        baseImponible 120.00: base sobre la cual se calcula el IVA.
        tarifa 15.00% : porcentaje de IVA aplicado.
        valorImpuesto 18.00: valor del IVA causado.
  • Luego se informan las retenciones practicadas sobre esa operación.

-> Primero, se retiene IVA:

        codigo 2: retención de IVA.
        codigoRetencion 3: código de retención de IVA correspondiente al 100%.
        baseImponible 18.00: la base de la retención de IVA es el IVA causado.
        porcentajeRetener 100.00: se retiene el 100% del IVA.
        valorRetenido 18.00: se retienen USD 18.00 de IVA.

-> Después, se retiene impuesto a la renta:

        codigo 1: retención de impuesto a la renta.
        codigoRetencion 304A: concepto específico de retención de renta según catálogo SRI.
        baseImponible 120.00: la base de la retención de renta es el valor sin impuestos.
        porcentajeRetener 10.00: se retiene el 10%.
        valorRetenido = 12.00: se retienen USD 12.00 de impuesto a la renta.

-> En total, se retienen:

           18.00 de IVA
        +  12.00 de renta
        =  30.00 retenidos
  • Finalmente, el bloque de pagos indica que el valor efectivamente pagado al proveedor es USD 108.00, usando la forma de pago 20, que corresponde a otros medios con utilización del sistema financiero.

El pago neto se calcula así:

         Total documento:       138.00
         menos retención IVA:   18.00
         menos retención renta: 12.00
Campos

Parámetro Descripción Tipo Obligatorio
taxSupportCode Tipo de sustento tributario del documento
01 -> Credito tributario para declaracion de IVA y sustento de costos.gastos
02 -> Costo o gasto para impuesto de renta, sin derecho a credito tributario
03 -> Activo fijo con derecho a crédito tributario
04 -> activo fijo sin derecho a credito tributario
05 -> Liquidación de gastos de viaje, hospedaje y alimentación
06 -> Inventario / costo de producción o comercialización
07 -> Reembolso de gastos
08 -> Importación de bienes
09 -> Otros casos sin derecho a crédito tributario o casos especiales según ATS
cadena SI
documentType Tipo de documento al que hace relación
01 -> Factura
02 -> Nota o boleta de venta
03 -> Liquidacion de compra de bienes o prestación de servicios
04 -> Nota de crédito
05 -> Nota de débito
06 -> Guia de remisión
07 -> Comprobante de retencion
08 -> Boleto de entradas a espectáculos públicos
09 -> Tiquetes o vales emitidos por maquinas registradoras<vbr/>11 -> Pasajes emitidos por empresas de aviación
12 -> Documentos emitidos por instituciones financieras
15 -> Comprobante de venta emitido en el exterior
16 -> Formulario único de exportación
18 -> Documentos autorizados para instituciones del estado
19 -> Comprobante de pago de cuotas o aportes
20 -> Documentos por servicios administrativos emitidos por instituciones de estado
41 -> Comprobante de venta emitido por reembolso
42 -> Documentos de retenci´on presuntiva o autoretención.
cadena SI
documentNumber Numero del documento cadena SI
issueDate fecha del documento (AAAAMMDD) cadena SI
paymentLocation Lugar donde se realiza el pago
01 -> Local, 02 -> Exterior
cadena SI
totalWithoutTaxes Total del documento antes de impuestosNumérico con dos decimales cadena SI
totalAmount Valor total del documento Numérico con dos decimales cadena SI
taxes Arreglo de objetos con los impuestos del documento original taxes objeto SI
withholdings Arreglo de objetos con las retenciones efectuadas a este documento withholdings objeto SI
payments Arreglo de pagos realizados y relacionados con este documento payments objeto SI
foreignPayment En caso de ser un pago al exterior, en este objeto se debe colocar la informacion referente al pais de pago foreignPayment objeto SI / NO


Enlaces

Importante

Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.
Si deseas tener un usuario y contraseña , comunícate con nosotros.