Diferencia entre revisiones de «API LaFactura.co:Retencion EC»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
(Página creada con «==Objeto:retencion== Es el objeto raiz, del sistema de envio de <b>Retenciones</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/>…»)
 
 
(No se muestran 6 ediciones intermedias del mismo usuario)
Línea 63: Línea 63:
 
                           "total":"108.00"
 
                           "total":"108.00"
 
                         }
 
                         }
    ],
+
                    ],
 
                     "foreignPayment":{
 
                     "foreignPayment":{
 
                           "regimeType":"01",
 
                           "regimeType":"01",
 
                           "paymentCountryCode":"840",
 
                           "paymentCountryCode":"840",
 
                           "doubleTaxationTreatyApplies":"false",
 
                           "doubleTaxationTreatyApplies":"false",
                           "foreignPaymentSubjectToWithholding":"true"
+
                           "foreignPaymentSubjectToWithholding":"true"
    }
+
                    }
        }
+
                }
 
             ]
 
             ]
 
           }
 
           }
 
         }
 
         }
 
  
 
=====Explicacion=====
 
=====Explicacion=====
Línea 90: Línea 89:
 
* Como es extranjero se adiciona el pago internacional (foreignPayment)
 
* Como es extranjero se adiciona el pago internacional (foreignPayment)
 
        
 
        
      01: el proveedor/pago corresponde a régimen general, no paraíso fiscal ni régimen fiscal preferente.
+
        01: el proveedor/pago corresponde a régimen general, no paraíso fiscal ni régimen fiscal preferente.
      840: el pago se efectúa hacia Estados Unidos.
+
        840: el pago se efectúa hacia Estados Unidos.
      No Se está aplicando un convenio para evitar doble tributación. (ejemplo)
+
        No Se está aplicando un convenio para evitar doble tributación. (ejemplo)
      El pago al exterior está sujeto a retención conforme a la norma legal. (ejemplo)
+
        El pago al exterior está sujeto a retención conforme a la norma legal. (ejemplo)
  
 
* 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:
 
* 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
+
        120.00 + 18.00 = 138.00
  
 
* En el bloque de impuestos del documento sustento se informa que el documento tiene IVA:
 
* En el bloque de impuestos del documento sustento se informa que el documento tiene IVA:
  
      Codigo 2: impuesto IVA.
+
        Codigo 2: impuesto IVA.
      codigoPorcentaje 4: tarifa de IVA 15%.
+
        codigoPorcentaje 4: tarifa de IVA 15%.
      baseImponible 120.00: base sobre la cual se calcula el IVA.
+
        baseImponible 120.00: base sobre la cual se calcula el IVA.
      tarifa 15.00% : porcentaje de IVA aplicado.
+
        tarifa 15.00% : porcentaje de IVA aplicado.
      valorImpuesto 18.00: valor del IVA causado.
+
        valorImpuesto 18.00: valor del IVA causado.
  
 
* Luego se informan las retenciones practicadas sobre esa operación.
 
* Luego se informan las retenciones practicadas sobre esa operación.
Línea 127: Línea 126:
 
-> En total, se retienen:
 
-> En total, se retienen:
 
          
 
          
        18.00 de IVA
+
            18.00 de IVA
      + 12.00 de renta
+
        + 12.00 de renta
      = 30.00 retenidos
+
        = 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.
 
* 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.
Línea 135: Línea 134:
 
El pago neto se calcula así:
 
El pago neto se calcula así:
  
        Total documento:      138.00
+
          Total documento:      138.00
        menos retención IVA:  18.00
+
          menos retención IVA:  18.00
        menos retención renta: 12.00
+
          menos retención renta: 12.00
  
 
=====Campos=====
 
=====Campos=====
Línea 153: Línea 152:
 
| note || Nota general en el documento || cadena || NO
 
| note || Nota general en el documento || cadena || NO
 
|-
 
|-
| shipment || Contiene la información perteneciente a fechas y lugar de partida del envío <small>'''[[API_LaFactura.co:shipment_remision_ec|shipment]]'''</small> || objeto || SI
+
| supplier || Contiene la información perteneciente al proveedor al cual se le realizó estas retenciones <small>'''[[API_LaFactura.co:supplier_retencion_ec|supplier]]'''</small> || objeto || SI
|-
 
| carrier || Contiene la información perteneciente al transportista <small>'''[[API_LaFactura.co:carrier_remision_ec|carrier]]'''</small> || objeto || SI
 
 
|-
 
|-
| recipients || Contiene la información de las entregas <small>'''[[API_LaFactura.co:recipients_remision_ec|recipients]]'''</small> || objeto || SI
+
| documents || Arreglo que contiene los documentos sujetos a retención <small>'''[[API_LaFactura.co:documents_retencion_ec|documents]]'''</small> || objeto || SI
 
|-
 
|-
 
| additionalInfo || Información adicional a adjuntar en el XML y PDF <small>'''[[API_LaFactura.co:Adicional_ec|additionalInfo]]'''</small> || objeto || NO
 
| additionalInfo || Información adicional a adjuntar en el XML y PDF <small>'''[[API_LaFactura.co:Adicional_ec|additionalInfo]]'''</small> || objeto || NO
Línea 176: Línea 173:
 
         },
 
         },
 
         "documento":{
 
         "documento":{
           "type":"ec_remision",
+
           "type":"ec_retencion",
 
           "process":"2",
 
           "process":"2",
           "tascode":"re-7327ad13609180eee1e8b347c69a9756-veca",
+
           "tascode":"rt-7327ad13609180eee1e8b347c69a9756-veca",
           "serial":"0306202606179127767800110010010000000010000257012",
+
           "serial":"0306202607179127767800110010010000000010000257012",
           "intID":"12EJS2B",
+
           "intID":"212121",
 
           "document":"001-001-000000001",
 
           "document":"001-001-000000001",
 
           "document_number":{
 
           "document_number":{

Revisión actual del 13:58 19 jun 2026

Objeto:retencion

Es el objeto raiz, del sistema de envio de Retenciones de nuestra API, es importante respetar todos los elementos aquí contemplados.


    Ingreso:     
    https://***.tas-la.com/facturacion.ec/local/
           
    Solicita tu usuario y contraseña +57-601-7466664
    No cobramos por el proceso de pruebas o desarrollo
    Y puedes empezar inmediatamente (sin certificados o papeleos)


Ejemplo de la Remision
   {
     "retencion":{
           "intID":"212121",
           "supplier":{
               "documentType":"08",
               "name":"Pedro Perez",
               "documentNumber":"AZ231987",
               "relationship":"false",
               "accounting":"false",
               "period":"202606",
               "email":"[email protected]"
           },
           "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 rcertificado 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.
  • Como es extranjero se adiciona el pago internacional (foreignPayment)
        01: el proveedor/pago corresponde a régimen general, no paraíso fiscal ni régimen fiscal preferente.
        840: el pago se efectúa hacia Estados Unidos.
        No Se está aplicando un convenio para evitar doble tributación. (ejemplo)
        El pago al exterior está sujeto a retención conforme a la norma legal. (ejemplo)
  • 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
issueDate Fecha de emision de este documento (AAAAMMDD)
De no enviarse se utilizará la fecha actual
cadena NO
issueTime Hora de emision de este documento (HHMMSS)
De no enviarse se utilizará la hora actual
cadena NO
intID Identificador único, de este documento en tu base de datos
Esta valor se utiliza como control para evitar repetir documentos en el sistema (Alfanumerico)
cadena SI
note Nota general en el documento cadena NO
supplier Contiene la información perteneciente al proveedor al cual se le realizó estas retenciones supplier objeto SI
documents Arreglo que contiene los documentos sujetos a retención documents objeto SI
additionalInfo Información adicional a adjuntar en el XML y PDF additionalInfo objeto NO


Resultados

Devuelve un objeto local con el resultado de la operación
Importante: Verifica toda la informacion que resultado devuelve ingresando al objeto.

 {
   "local":{
       "status":{
          "code":200,
          "text":"Procesado con éxito"
       },
       "documento":{
          "type":"ec_retencion",
          "process":"2",
          "tascode":"rt-7327ad13609180eee1e8b347c69a9756-veca",
          "serial":"0306202607179127767800110010010000000010000257012",
          "intID":"212121",
          "document":"001-001-000000001",
          "document_number":{
              "unit":"001",
              "subUnit":"001",
              "secuence":"000000001"
          }
       }
    }
  }
A tener presente

  • El resultado incluye el campo "tascode", que es el codigo único interno en nuestro sistema e identifica el documento. Es requerido para cualquier acción posterior sobre este documento. (Es importante conservarlo)
  • No se debe considerar un documento como válido por la SRI, hasta que el resultado de una verificación del documento, muestre a estado con: 2

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.