Saltar al contenido principal

¿Cómo enviar Documentos Tributarios a Multivende?

Actualización

 

Se pueden adjuntar archivos tanto las ventas (Checkouts) como los despachos (DeliveryOrder) en formato PDF con un peso máximo de 1MB, para ello se requiere identificar los respectivos _ids de la venta o del despacho.

Subir documentos electrónicos a las ventas

Primero se tiene que crear un registro en Multivende del DTE usando el siguiente endpoint Create checkout electronic billing document, dentro del body estarás enviando la siguiente información: 

Request:

curl --location -g '{{base_url}}/api/checkouts/{{checkout_id}}/electronic-billing-documents' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
"ClientId": "{{client_id}}",
"id": "XXXXXXX",
"emissionDate":"2019-03-01",
"type":"electronic_billing_electronic_bill",
"provider":"test_provider_code",
"ElectronicBillingDocumentEmitterId":"{{electronic_billing_document_emitter_id}}"
}'

Response:

{
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"status": "created",
"ClientId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"id": "8877777",
"emissionDate": "2019-03-01T00:00:00.000Z",
"ElectronicBillingDocumentEmitterId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ElectronicBillingDocumentTypeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ElectronicBillingDocumentProviderId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"CheckoutId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"updatedAt": "2019-08-29T15:26:33.000Z",
"createdAt": "2019-08-29T15:26:33.000Z"
}

 

Una vez se cree el registro del DTE, con el "_Id" del response, se adjuntan los archivos, tenemos dos endpoints que permiten realizar la carga de archivos en  pdf o base64:

 

 

La carga de los DTE desde Multivende a los canales de venta se tiene habilitado para:

  • Mercado Libre
  • Paris
  • Ripley
  • Falabella
  • Coppel
  • Walmart (Habilitado sólo para México)
  • VTEX

A continuación te detallamos algunas consideraciones a tener en cuenta en la carga de los documentos tributarios para los siguientes canales de ventas: 

Consideraciones para VTEX

  • En el caso de VTEX se envía el documento tributario al canal, solo cuando esta cargado el PDF y luego se marca la orden como enviada.

Consideraciones para Falabella

  • La creación del registro del DTE y posterior subida solo es permitida cuando la orden se encuentra en los siguientes estados:
    • "ready_to_ship",
    • "delivered",
    • "shipped".

De lo contrario el documento quedará con error de sincronización.

Consideraciones para Walmart México

  • Deben esperar a que la orden tenga la información de facturación dentro del campo"billingClient" para poder realizar la generación del DTE, ya que, un cliente puede solicitar factura dentro de los 30 días próximos a la venta; es en ese entonces cuando deben realizar la generación del documento correspondiente.
  • En el caso de Walmart debes realizar previamente la configuración de Apolo en Multivende, en este artículo encontrarás los pasos a seguir.

Consideraciones para el caso de las ventas del marketplace Paris

  • El tiempo necesario para completar una orden en Paris puede variar, y en algunos casos, puede ser necesario esperar un poco más para recibir la orden completa. Dado el funcionamiento de Paris, el canal puede informar sobre despachos (sub-órdenes) asociados a una venta un tiempo después de haber recibido la venta

  • Para identificar cuándo una orden en Paris ha sido actualizada con nuevos ítems y despachos, utiliza el parámetro .tags = 'order_externally_updated'.

  • Dado esto, te recomendamos que generes las boletas correspondientes a las transacciones de Paris después de un período específico.

  • El tiempo recomendado para hacerlo es de 2 horas, para permitir que el proceso anterior se complete correctamente y el documento se suba directamente a la venta.

  • Se recomienda subir el documento tributario a los despachos o si después de cargar la boleta directamente a la venta se agregan nuevos despachos, puedes adjuntar la boleta a estos mediante la funcionalidad de subir documentos electrónicos a los despachos, que se explica a continuación.

Subir documentos electrónicos a los despachos

Primero se tiene que crear el registro en Multivende del DTE usando el siguiente endpoint Create delivery order electronic billing document 

Para lo que se requiere conocer:

curl --location -g '{{base_url}}/api/delivery-orders/{{delivery_order_id}}/electronic-billing-documents' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
"ClientId": "{{client_id}}",
"id": "XXXXXXX",
"emissionDate":"2019-03-01",
"type":"electronic_billing_electronic_bill",
"provider":"test_provider_code",
"ElectronicBillingDocumentEmitterId":"{{electronic_billing_document_emitter_id}}"
}'

 

Response:

{
"_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "created",
"ClientId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"id": "8877777",
"emissionDate": "2019-03-01T00:00:00.000Z",
"ElectronicBillingDocumentEmitterId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"CreatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"UpdatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"MerchantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ElectronicBillingDocumentTypeId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ElectronicBillingDocumentProviderId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"DeliveryOrderId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"updatedAt": "2019-08-29T15:27:24.000Z",
"createdAt": "2019-08-29T15:27:24.000Z"
}

Una vez se cree el registro del DTE, con el _id del response, se adjunta como tal los archivos (.pdf, .zip, entre otros) por medio del endpoint Upload file to electronic billing document.

 

Códigos de tipos (type) permitidos para los DTEs

  • electronic_billing_electronic_invoice
  • electronic_billing_not_taxed_electronic_invoice
  • electronic_billing_electronic_bill
  • electronic_billing_not_taxed_electronic_bill
  • electronic_billing_not_taxed_debit_note
  • electronic_billing_not_taxed_credit_node

 

Para los Providers (proveedor)

Esta información se tiene que canalizar vía correo api@multivende.com solicitando un código de proveedor según el proveedor (generador de boletas) que estén usando. Enviando la siguiente información:

  • Sistema DTE.
  • Empresa desarrolladora de la integración.
  • Merchant ID.

Multivende genera el código y lo informa de vuelta en el correo de la solitud.

 

Para los Emisores de documentos (ElectronicBillingDocumentEmitterId)

Puedes seguir los pasos del siguiente artículo ¿Cómo crear un emisor de documentos?.  En caso de cualquier duda comunicarse con onboarding@multivende.com , ellos lo asistirán en la generación de este identificador.

Si deseas realizar este proceso via API, puedes crear el emisor de documentos mediante el endpoint Create electronic billing document emitter enviando los siguientes campos:

{
  "name": "nombre asociado al emisor de documentos",
  "code":"código",
  "taxId":"RUT/NIT",
  "taxName":"razón social"
}

*Rellena el campo código con 01111

En la respuesta del endpoint puedes identificar el _id asociado al emisor del documento electrónico, este proceso se realiza sólo una vez y el emisor de documento electrónico queda asociado a la cuenta del merchant.

 

Response:

{
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"status": "created",
"name": "Test emitter",
"code": "01010",
"taxId": "76449667-3",
"taxName": "Test emitter SPA",
"MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"updatedAt": "2019-08-28T19:58:12.000Z",
"createdAt": "2019-08-28T19:58:12.000Z"
}

 

Puedes consultar el _id del emisor de documento asociado a la cuenta de un merchant mediante el endpoint: Get electronic billing document emitters

 

Consulta de documentos electrónicos

Para consultar los documentos electrónicos de una orden puedes consultar al siguiente endpoint Get electronic billing documents of a checkout

 

Consideraciones para tipos de envío Fulfillment

Si se trata de una orden de tipo Fulfillment, recuerda que para verificar el tipo de envío debes consultar el campo "shippingMode".

shippingMode: fulfillment
  • Paris: 

    • El seller debe solicitar la configuración de Fulfillment a Paris, y el canal se encarga de emitir la boleta.

  • Mercadolibre:
    • Argentina, Colombia y México, el vendedor puede generar la factura.
    • Brasil y Chile, Mercado Libre siempre genera la factura.
  • Falabella
    • Falabella se encarga de la emisión de la boleta.
  • Ripley
    • Para registrar tus ventas de Fulfillment by Ripley desde Multivende, es necesario que tengas una cuenta nueva creada en Ripley. Asegúrate de tener este requisito cumplido antes de solicitar la integración. La boleta es generada por el marketplace para estas ventas.

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


Equipo Integraciones API Multivende

 

Artículos relacionados