Etiqueta de Frete - Direct

Este Guia Técnico consiste em normatizar e estabelecer o padrão da etiqueta do serviço de frete B2W Entrega Direct emitida no ambiente via API.

Modelo de Etiqueta

Os tópicos presentes neste Guia Técnico possibilitam o correto desenvolvimento e garante a padronização de todas as etiquetas emitidas para os sellers que utilizam o serviço de frete B2W Entrega via API. Com isso, o fluxo operacional de entrega e identificação visual por parte da operação da transportadora responsável pela entrega das encomendas é assertivo e segue o padrão pré-estabelecido pelos mesmos.

B2W Entrega – Direct

A etiqueta do B2W Entrega tendo como seu transportador a Direct, tem informações vitais e específicas para todo o processo de entrega e todos os campos que serão referenciados abaixo devem ser parte integrante da etiqueta desta modalidade:

  1. Logo da Marca (B2W Entrega)

  2. QR Code

  3. Símbolo de Encaminhamento

  4. Informação de Volumes

  5. Nota Fiscal

  6. Número do Pedido

  7. Número do Packing List

  8. DtPr (informação interna Direct)

  9. Código de Rastreamento

  10. Código de Barras (AWB)

  11. Dados de Recebedor (Recebedor, Assinatura, Documento)

  12. Dados de Destinatário (Nome, Endereço, Bairro, Complemento, CEP, Cidade e UF)

  13. Código de Barras do CEP

  14. Campo Base/Rota (informação interna Direct)

  15. Campo Menu de Frete (informação interna B2W)

  16. Dados do Remetente (Vendedor, Endereço, CEP, Cidade e UF)

Medidas e Posição dos Campos

As medidas de toda a etiqueta, assim como o devido posicionamento de todos os seus campos e elementos, devem segui exatamente as cotas abaixo:

Fontes e Logos

Todas as fontes, tamanhos e suas aplicações presentes em todos os campos que são parte integrante da etiqueta do B2W Entrega seguem um padrão referenciado pelos transportadores do serviço e sua aplicação deve ser exatamente conforme descrito na tabela abaixo:

Fontes

Logos

O serviço B2W Entrega é identificado por 3 variações de logos conforme ilustração abaixo. Esta identificação visual tem como objetivo principal o selo de garantia da qualidade e reputação do serviço de entrega oferecido ao cliente final, assim como são facilmente identificados dentro da operação dos transportadores com as quais o serviço de entrega é prestado, sendo assim de suma importância a presença destes elementos na etiqueta do serviço:

Este logo é aplicado quando o site utilizado para a compra do cliente for Americanas.com
Este logo é aplicado quando o site utilizado para a compra do cliente for a Submarino.com
Este logo é aplicado quando o site utilizado para compra do cliente for a Shoptime.com

Atenção: Para cada entrega este logo varia conforme regras acima, e não é desejável aplicar apenas um deles como padrão fixo.

Símbolos de Encaminhamento

Os símbolos de encaminhamento são ícones que representam o conjunto de serviços de envio de encomendas dos Correios. Tais símbolos tem o objetivo de identificar visualmente a linha da encomenda e são usados para os serviços conforme abaixo:

Este símbolo é aplicado em todas as etiquetas Direct

Atenção: É expressamente proibido a inserção de qualquer logo nesta etiqueta que não seja o das marcas oficiais da B2W reproduzidas através da marca do seu produto B2W Entrega, contidas neste Guia.

Como obter a minha etiqueta de frete na API SkyHub?

Lista de Pedidos Aptos ao Agrupamento

GET /shipments/b2w/to_group

Atualmente são disponibilizados 20 pedidos por página via API, mas nós disponibilizamos o recurso de paginação para este Endpoint.

Segue abaixo um exemplo de como realizar a paginação de pedidos aptos para agrupamento:

GET https://api.skyhub.com.br/shipments/b2w/to_group?offset=1

O limite de pedidos para incluir no agrupamento atualmente é de 25.

Example Request:

curl --request GET \
--url https://api.skyhub.com.br/shipments/b2w/to_group \
--header 'accept: application/pdf' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaApiKey' \
--header 'x-user-email: seu@email.com'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/pdf

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Você também pode utilizar o Header accept como application/json para receber a etiqueta em formato Json.

Responses:

200 Success - Postagem (PLP) Get - retorno 200 lista de pedidos aptos ao agrupamento

Listar PLP's

GET /shipments/b2w/

Função que permite verificar na API todas as PLP's agrupadas. No retorno será possível verificar o ID da PLP e os pedidos inseridos em cada agrupamento.

Example Request:

curl --request GET \
--url https://api.skyhub.com.br/shipments/b2w/ \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaAPIKey' \
--header 'x-user-email: seu@email.com'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Responses:

200 Success: Postagem (PLP) Get - listar PLP's

Agrupar Pedidos em uma PLP

POST /shipments/b2w/

Ao efetuar o POST para agrupar a PLP retornará a ID da PLP. Com a ID da PLP será necessário recuperar a PLP.

Example Request:

curl --request POST \
--url https://api.skyhub.com.br/shipments/b2w/ \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaApiKey' \
--header 'x-user-email: seu@email.com' \
--data '{"order_remote_codes":["265358194401","265358194401","265358194401"]}'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Request Body:

{
"order_remote_codes": [
"265358194401",
"265358194401",
"265358194401"
]
}

Responses:

200 Success: "message": "Plp 14 agrupada com sucesso."

Desagrupar PLP:

DELETE /shipments/b2w/

Example Request:

curl --request DELETE \
--url https://api.skyhub.com.br/shipments/b2w/ \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaApiKey' \
--header 'x-user-email: seu@email.com'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

XACCOUNT

Request Body:

{
"plp_id": "14"
}

200 - Success: "message": "Plp 14 desagrupada com sucesso."

Recuperar PLP - PDF

GET /shipments/b2w/view?plp_id={CODE}

Para recuperar a PLP é necessário primeiro efetuar o agrupamento da PLP para receber o ID e passar no Endpoint.

Caso queria retornar os dados da etiqueta em formato JSON, deve-se passar o header Accept: application/json.

Example Request:

curl --request GET \
--url 'https://api.skyhub.com.br/shipments/b2w/view?plp_id=%7BCODE%7D' \
--header 'accept: application/pdf' \
--header 'content-type: application/json' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaApiKey' \
--header 'x-user-email: seu@email.com'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

XACCOUNT

Responses:

200 - Success: "Response": PDF ou Json da PLP

Coleta:

Será obrigatório após a emissão da etiqueta que haja a solicitação da coleta dos pedidos. Nesta solicitação é importante que seja informado quais pedidos estão aptos para serem coletados.

Atenção: Caso não haja a solicitação, a Direct não irá efetuar a coleta.

Segue a baixo o processo para que seja confirmado a coleta:

Aptos à Coleta

Após emitir a etiqueta, será necessário efetuar o GET dos pedidos e verificar quais estão aptos para a coleta.

GET /shipments/b2w/collectables?requested=false&offset=1

Example Request:

curl--request GET\
--url 'https://api.skyhub.com.br/shipments/b2w/collectables?requested=false&offset=1' \
--header 'accept: application/json'\
--header 'content-type: application/json'\
--header 'x-accountmanager-key: SUAXACCOUNT'\
--header 'x-api-key: SuaApiKey'\
--header 'x-user-email: seu@email.com'\

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

XACCOUNT

Query Parameters:

Name

Type

Required

Description

Example

requested

String

Required

entregas que já tiveram sua coleta solicitada

true ou false

offset

integer

opcional

paginação, inicia em 1 e hoje por padrão retorna de 20 em 20 registros.

1

Response:

200 - Success:

{ "orders": [{ "code": "158258462", "customer": "Rubia", "value": 10 }, { "code": "158260587", "customer": "Rubia", "value": 10 }, { "code": "158260588", "customer": "Rubia", "value": 10 } ] }

Solicitar Coleta

Após verificar quais os pedidos aptos a serem coletados, o próximo passo é solicitar a coleta:

POST /shipments/b2w/confirm_collection

Example Request:

curl--request POST\
--url https://api.skyhub.com.br/shipments/b2w/confirm_collection \
--header 'accept: application/json'\
--header 'content-type: application/json'\
--header 'x-accountmanager-key: SUAXACCOUNT'\
--header 'x-api-key: SuaApiKey'\
--header 'x-user-email: seu@email.com'\
--data '{"order_codes":["158260592"]}'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

XACCOUNT

Response:

200 - Success:

{

"message": "Confirmacao para coleta realizada com sucesso."

}