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

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", ten en cuenta que:

- El campo type hace referencia a si es una persona o una compañía.

- El campo taxActivity hace referencia al giro o actividad fiscal.

- El campo taxId, contiene la información del número de documento.

"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" or "person"
    "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"
  }
]

ℹ️ Información: 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, debes consultar el campo: "ElectronicBillingDocumentType". El cual entregará los siguientes valores:

Si se requiere Boleta/Factura no fiscal:

"ElectronicBillingDocumentType": {
        "_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxx",
        "name": "ELECTRONIC_BILLING_DOCUMENT_TYPES.Electronic_bill.Name",
        "code": "electronic_billing_electronic_bill"
    }

Si se requiere Factura/Factura fiscal:

"ElectronicBillingDocumentType": {
        "_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxx",
        "name": "ELECTRONIC_BILLING_DOCUMENT_TYPES.Electronic_bill.Name",
        "code": "electronic_billing_electronic_invoice"
    }

Equipo Integraciones API Multivende

0 comentarios

¿No encontraste lo que buscabas?