Parceiros integrados via HUB e ERPs podem imprimir etiquetas do Dafiti Envios através da API. Para otimizar o fluxo automatizado, essa funcionalidade pode ser utilizada diretamente na plataforma/ERP integrado. As seguintes chamadas devem ser realizadas (nesta ordem):
Consulte nossa documentação sobre como utilizar essas chamadas:
https://api.sellercenter.com.br/docs/
Alterar o status para embalado (Gerar etiqueta)
/v2/orders/statuses/set-to-packed-by-marketplace
{ "orderItems": [ { "orderItemId": 8995 } ], "shippingProvider": "Dafiti Envios" }
1.1 Execute o GetOrderItems para obter o código de rastreamento, que será necessário na próxima chamada.
https://api.sellercenter.com.br/docs/#/Orders/GET_v2-order-items-get
Alterar o status para pronto para envio
/v2/orders/statuses/set-to-ready-to-ship
Recuperar a etiqueta
/v2/orders/export-document
*documentType deve ser sempre = shippingParcel
** Para baixar a etiqueta, utilize o retorno:
downloadLinks": [ "/export/index/download/key/101889405 (número fictício)
e concatene esse resultado com o endereço https://sellercenter.com.br/ para gerar:
https://sellercenter.com.br/export/index/download/key/101889405
ou utilize a chamada:
https://api.sellercenter.com.br/docs/#/Files/get_filemanager_v1_files_download__uuid_
Fechar PLP
/v2/order-pickup-requests
Pontos importantes
Para todas as chamadas, é necessário ter o orderItemId, API Key e o UserID do SellerCenter.
O campo “ShippingProvider” deve ser preenchido como “Dafiti Envios”.
Documentação - API – Envios – Passo a passo.
1- Chamar getOrders para obter a lista de orderId.
● https://api.sellercenter.com.br/docs/#/Orders/get_v2_orders
2- Após recuperar todos os pedidos, é necessário obter a identificação dos itens dos
pedidos (OrderItemId). Isso pode ser obtido de 2 maneiras:
Chamar o getOrderItems para obter os respectivos OrderItemId e usá-los em todos
os passos seguintes
● https://api.sellercenter.com.br/docs/#/Orders/GET_v2-order-items-get
3- Chamar setStatusToPackedByMarketplace para gerar o packageId e o
trackingNumber
● https://api.sellercenter.com.br/docs/#/Orders/post_v2_orders_statuses_set_to_packed_by_marketplace
{
"orderItems": [
{
"orderItemId": "12411"
}
],
"deliveryType": "dropship",
"shippingProvider": "Dafiti Log"
}
3.1 Rodar a GetOrderItens para obter o Tracking que será necessário na próxima chamada.
https://api.sellercenter.com.br/docs/#/Orders/GET_v2-order-items-get
4- Chamar o setStatusToReadyToShip, informando invoiceKey, InvoiceEncodedXml,
shippmentprovider e trackingNumber obtido anteriormente no passo 2, para virar o
status do pedido para ready to ship
● https://api.sellercenter.com.br/docs/#/Orders/post_v2_orders_statuses_set_to_ready_to_ship
5- Chamar o createForwarderManifest para atrelar os itens de pedido ready to ship
a um manifesto(packlist) e, assim, dar início ao fluxo de coleta.
● https://api.sellercenter.com.br/docs/#/Manifest/post_v2_manifest
6- Chamar o getDocument passando a lista de Ids dos Itens do Pedido
(OrderItemIds) para obter o base64 das respectivas etiquetas a serem usadas nos
itens embalados. Esse base64 deve ser convertido no PDF no qual conterá as
etiquetas solicitadas.
● https://api.sellercenter.com.br/docs/#/Orders/post_v2_orders_export_document
*documentType sempre será = shippingParcel
** Para fazer download da etiqueta você pode pegar o retorno:
downloadLinks": [ "/export/index/download/key/101889405 (número ficticio)
e concatenar esse resultado com o endereço https://sellercenter.com.br/ para gerar:
https://sellercenter.com.br/export/index/download/key/101889405
ou utilizar a chamada:
https://api.sellercenter.com.br/docs/#/Files/get_filemanager_v1_files_download__uuid_
Os passos seguintes são realizados pela Dafiti. Então, basta programar uma rotina de
getOrderItems para obter as atualizações de status e acompanhar a evolução
**Importante: o nome do arquivo XML precisa ser a numeração da chave da NF: exemplo:
35231239303943000129550010000231151823550890.xml
Abaixo o Link com a documentação completa do passo a passo e com exemplos das execuções.