Saltar al contenido principal

Información de Facturación: Cómo consultarla y entenderla

Actualización

En este artículo detallamos la información de la facturación referente a una venta según el Canal.

Lo primero que debes realizar es consultar la orden enviando el ID mediante el Endpoint Get Checkout, los detalles para la información de facturación puedes obtenerla dentro de nuestros campos normalizados en Multivende, consultando dentro de "Client" donde podrás obtener todos los datos relacionados al cliente y dentro del campo "BillingAddresses" los detalles en relación a la dirección de facturación.

"Client": {
   "fullName": "",
   "_id": "a8e48e5c-XXXX-4dab-9ec3-XXXXXXXXXXXX",
   "name": "",
   "lastName": "",
   "activity": null,
   "contactName": null,
   "comune": null,
   "city": null,
   "documentType": null,
   "taxId": "XXXXXXXX-X",
   "birthday": null,
   "code": null,
   "email": null,
   "phoneNumber": null,
   "comment": null,
   "type": "person",
   "tags": null,
   "status": "created",
   "createdAt": "2020-11-04T19:32:04.000Z",
   "updatedAt": "2020-11-04T19:32:04.000Z",
   "CreatedById": "af718539-XXXX-4413-8c83-XXXXXXXXXXXX",
   "UpdatedById": "68a88914-XXXX-414e-9d3c-XXXXXXXXXXXX",
   "ClientId": "a8e48e5c-XXXX-4dab-9ec3-XXXXXXXXXXXX",
   "MerchantId": "be133293-XXXX-4f01-822a-XXXXXXXXXXXX"

   "BillingAddresses": [
       {
          "_id": "30feddc9-XXXX-4951-816b-XXXXXXXXXXXX",
          "name": "Full Name",
          "address_1": "Coquimbo - IV - Coquimbo, Chile",
          "address_2": "General Bartolome Blanche XXX",
          "description": null,
          "indications": null,
          "position": 0,
          "status": "created",
          "importance": "principal",
          "createdAt": "2023-03-10T13:02:10.000Z",
          "updatedAt": "2023-03-10T13:02:10.000Z",
          "CreatedById": "af718539-XXXX-4413-8c83-XXXXXXXXXXXX",
          "UpdatedById": "68a88914-XXXX-414e-9d3c-XXXXXXXXXXXX",
          "ClientId": "a8e48e5c-XXXX-4dab-9ec3-XXXXXXXXXXXX",
          "MerchantId": "be133293-XXXX-4f01-822a-XXXXXXXXXXXX"
      }
   ]
}
  • Para identificar la información de facturación del cliente debes consultar el campo "CheckoutBillingClients"
"CheckoutBillingClients": [
 {
   "_id": "9f1839df-XXXX-4a05-XXXX-2e4024XXXXXX",
   "name": "Multivende",
   "taxName": null,
   "taxActivity": null,
   "taxId": "XXXXXXXXX",
   "documentType": "RUT",
   "legalRepresentative": null,
   "legalRepresentativeTaxId": null,
   "email": null,
   "phoneNumber": null,
   "type": "company",
   "status": "created",
   "createdAt": "2024-01-12T12:41:08.000Z",
   "updatedAt": "2024-01-12T12:41:08.000Z",
   "BillingAddressId": "02e22a7b-7850-4204-8728-78a888ae09c7",
   "CheckoutId": "0d85a156-9c81-XXXX-XXXX-7908e8XXXXXX",
   "CreatedById": null,
   "UpdatedById": null,
   "MerchantId": "4df759c7-XXXX-4cad-XXXX-a5e954XXXXXX"
 }
],
Dentro del campo "type" se informará si corresponde a persona ("person") o compañía ("company"), pero debes tener en consideración que no todos los canales de venta informan esto, por consiguiente este campo llegaría como "person" por defecto.
 
Si necesitas obtener la información para saber si una venta corresponde a boleta o factura, actualmente esta información no la tenemos estandarizada como campo de Multivende.
Se debe tomar del "CheckoutLink" --> "externalConntent".
 
Puedes identificar el canal de venta consultando el campo "origin". A partir de allí se debe identificar la información de acuerdo a cada Marketplace:
 
  • Dafiti - Linio y Falabella

Esta se informa dentro del campo "InvoiceRequired"

"InvoiceRequired": "false" (Boleta)

"InvoiceRequired": "true" (Factura)
  • Mercadolibre:

Se informa dentro de "billing_info" --> "additional_info"

En caso de Persona Jurídica (Factura), MercadoLibre dentro del "additional_info" incluye la siguiente información:

  • business_name: Nombre de la entidad jurídica que compra
  • taxpayer_type_id: posición de la entidad jurídica ante el IVA

Si la venta se tratase de una boleta estos campos no vienen informados dentro del "additional_info".

"billing_info": {
"doc_type": "RUT",
"doc_number": "XXXXXXXX",
   "additional_info": [
   {
    "type": "DOC_NUMBER",
    "value": "XXXXXXXX"
   },
   {
    "type": "COMMENT",
    "value": "FARMACIA"
   },
   {
    "type": "BUSINESS_NAME",
    "value": "HERNAN"
   },
   {
    "type": "STATE_NAME",
    "value": "La Araucanía"
   },
   {
    "type": "SITE_ID",
    "value": "MLC"
   },
   {
    "type": "DOC_TYPE",
    "value": "RUT"
   },
   {
    "type": "COUNTRY_ID",
    "value": "CL"
   },
   {
    "type": "ECONOMIC_ACTIVITY",
    "value": "FARMACIA"
   },
}

Dejamos la documentación de la API de Mercado Libre para que puedan ver los campos relacionado a la información de facturación.

  • Paris:

Se informa dentro del campo "originInvoiceType".

"originInvoiceType": "boleta"

"originInvoiceType": "factura"
  • Ripley:

Se informa dentro del campo "has_invoice"

"has_invoice": false (Boleta)

"has_invoice": true (Factura)
  • Shopify

Se informa dentro de los campos "CheckoutLink" --> "tags"

"tags":[
     "CS_AIOD",
     "CS_APPLIED_SHOPIFY_DISCOUNT",
     "EXTRACYBER",
     "FACTURA",
     "Packed at 16:14 on marzo 29 2023",
     "Packed at 16:15 on marzo 29 2023",
     "PLAZA"
],
  • VTEX

Se informa dentro del campo "clientProfileData" --> "isCorporate"

"isCorporate": true (Factura)

 

Si tienes dudas sobre esto contáctanos a través de api@multivende.com y estaremos felices de ayudarte.

Equipo Integraciones API Multivende

Artículos relacionados