Parceiros integrados via HUB e ERP’s, podem realizar a impressão das etiquetas do Dafiti Envios via API. Com o intuito de otimizar o fluxo automatizado a funcionalidade pode ser utilizada diretamente na plataforma/ERP integrado.

É necessário realizar as seguintes chamadas (Ordem):

Favor checar nossa documentação sobre o uso das chamadas:

https://api.sellercenter.com.br/docs/

1. Alterar o status para embalado (Gerar etiqueta)

/v2/orders/statuses/set-to-packed-by-marketplace 

{

  "orderItems": [

    {

      "orderItemId": 8995

    }

  ],

  "shippingProvider": "Dafiti Envios"

}

1.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

2. Alterar o status pronto para envio

/v2/orders/statuses/set-to-ready-to-ship 

3. Resgatar a etiqueta

/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_

4. Fechar PLP

/v2/order-pickup-requests 

Pontos importantes

Para todas as chamadas é necessário ter o orderItemId, Chave da API e UserID do SellerCenter. 

O campo “ShippingProvider” deve ser definido como “Dafiti Envios”.

Fluxo API para Milkrun

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.