Diferencia entre revisiones de «API LaFactura.co:ExchangeRate»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
(Página creada con «==exchange== Para generar una factura a través de la API y realizar los procesos de verificación, elaboracion, firmado y envío a la DIAN, debes realizar una petición ''…»)
 
 
(No se muestran 25 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
==exchange==
+
==Objeto:exchangeRate==
Para generar una factura a través de la API y realizar los procesos de verificación, elaboracion, firmado y envío a la DIAN, debes realizar una petición '''POST''', a la URL incluyendo el formato JSON con la información propia de la factura a ser generada.<br><br>
+
 
 +
Es un objeto usado en '''[[API_laFactura.co:invoice|invoice]]'''. Permite enviar al sistema, entre la información propia de la factura a ser generada, lo referente a monedas y tasas. Su uso es necesario cuando se hace una factura internacional en Dólares o si es una factura elaborada a un extranjero
 +
 
 
=====Ejemplo=====
 
=====Ejemplo=====
  
  {
+
      "exchangeRate":{
    "invoice":
+
          "currencyCode":"USD",
    {
+
          "currencyRate":"3800.00",
      "rangeKey":"219832728",
+
          "currencyDate":"20200321"
      "issueDate":"20200317",
+
       }
      "issueTime":"100521",
+
 
       "dueDate" : "20200417",
+
=====Explicacion=====
      "note1" : "Esta es una nota en la factura",
+
 
      "customizationID" : "01",
+
Se está enviando una tasa de cambio de pesos colombianos a dólares americanos por $3800.00 y la fecha de negociacion/TRM fue la del 2020.03.21
      "customer" : {
+
 
          "additionalAccountID":"01",
+
=====Campos=====
          "name":"Pepito Perez y Cia SAS",
+
----
          "city":"Bogotá"
+
 
          "address":"Av 19 No. 11-11 Of 40-09",
+
{| class="wikitable"
          "document":"900900651",
+
|-
          "documentType":"01",
+
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
          "phone":"3112196942",
+
|-
          "email":"ejemplo@ejemplo.com"
+
| currencyCode || Tipo de Moneda<br><small>USD -> Dólares Americanos<br/>COP -> Pesos Colombianos</small> || cadena || SI || v2.0 / v3.0
      },
+
|-
      "amounts":{
+
| currencyRate || Cambio con respecto al peso colombiano<br><small>Si es venta en COP, colocar 1.00<br/>(con dos decimales)</small>|| cadena || SI || v2.0 / v3.0
          "totalAmount":"120000.00",
+
|-
          "taxAmount":"19000.00",
+
| currencyDate || Fecha del valor de la tasa<br><small>presentado en formato (YYYYMMDD)</small> || cadena || SI || v2.0 / v3.0
          "payAmount":"139000.00"
+
|}
      },
+
 
      "taxes":{
+
<span style="color:#009999"><b>Notas para migrantes de API v2.0 a v3.0:</b></span>
          [
+
----
            "ID":"IVA",
+
* No hay cambios en este objeto<br/>
            "taxableAmount":"100000.00",
+
 
            "taxAmount":"19000.00",
+
==Usado por==
            "percent":"19.00"
+
Los siguientes recursos:
          ]
+
* [[API_LaFactura.co:Generar_Factura|Generar Factura]]
      },
+
Los siguientes objetos:
      "items":{
+
* [[API_laFactura.co:invoice|invoice]]
          [
+
 
            "quantity":"5.00",
+
==Temas complementarios==
            "unitPrice":"20000.00",
+
* [[API_LaFactura.co:Facturacion|Facturación]]
            "total":"100000.00",
+
 
            "description":"Horas de soporte remoto",
+
==Enlaces==
            "brand":"LF",
+
*LaFactura.co: https://lafactura.co
            "model":"Soporte",
+
*GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
            "taxes":{
 
                [
 
                  "ID":"IVA",
 
                  "taxableAmount":"100000.00",
 
                  "taxAmount":"19000.00",
 
                  "percent":"19.00"
 
                ]
 
            }
 
          ],
 
          [
 
            "quantity":"1.00",
 
            "unitPrice":"20000.00",
 
            "total":"20000.00",
 
            "description":"Servicio sin IVA",
 
            "brand":"LF",
 
            "model":"Serv1",
 
          ]
 
      }
 
    }
 
  }
 
  
=====Explicación=====
+
==Importante==
Se está solicitando la creación de una factura por un total de $139.000 Pesos, para el cliente Pepito Perez y Compañía SAS, con:<br><br>
+
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br>
* 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000 + IVA ($19.000)<br>
+
'''Si deseas tener un usuario y contraseña , comunícate con nosotros.'''
* 1 Hora de servicio sin IVA por un valor de $20.000<br>
 
* El total antes de impuestos es de $120.000<br>
 
* Los impuestos son: $ 19.000<br>
 
* El total en factura en: $ 139.000<br>
 

Revisión actual del 19:55 4 may 2021

Objeto:exchangeRate

Es un objeto usado en invoice. Permite enviar al sistema, entre la información propia de la factura a ser generada, lo referente a monedas y tasas. Su uso es necesario cuando se hace una factura internacional en Dólares o si es una factura elaborada a un extranjero

Ejemplo
     "exchangeRate":{
          "currencyCode":"USD",
          "currencyRate":"3800.00",
          "currencyDate":"20200321"
     }
Explicacion

Se está enviando una tasa de cambio de pesos colombianos a dólares americanos por $3800.00 y la fecha de negociacion/TRM fue la del 2020.03.21

Campos

Parámetro Descripción Tipo Obligatorio API
currencyCode Tipo de Moneda
USD -> Dólares Americanos
COP -> Pesos Colombianos
cadena SI v2.0 / v3.0
currencyRate Cambio con respecto al peso colombiano
Si es venta en COP, colocar 1.00
(con dos decimales)
cadena SI v2.0 / v3.0
currencyDate Fecha del valor de la tasa
presentado en formato (YYYYMMDD)
cadena SI v2.0 / v3.0

Notas para migrantes de API v2.0 a v3.0:


  • No hay cambios en este objeto

Usado por

Los siguientes recursos:

Los siguientes objetos:

Temas complementarios

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.