Após identificar o pedido Envvias (“envvias”: true) com status de pagamento aprovado (PAY) no endpoint /orders, serão necessárias duas requisições POST para a continuidade do processo e atualização dos pedidos.

A primeira requisição será para o cadastro da nota fiscal e a segunda, para emissão da etiqueta do pedido.

1ª requisição - Endpoint responsável pelo cadastro da nota fiscal:

• Base URL: https://api-mktplace.viavarejo.com.br/api/v2

• Endpoint: /orders/{​​​​​orderId}​​​​​/trackings/invoice

• Headers: client_id, access_token e orderId

• Method: POST

• Link Dev Portal: Clique aqui

Payload:

​

Confira o detalhamento:

• items: Sku do produto seguido de um "hífen" e a quantidade (campo obrigatório);

• occurredAt: Data da ocorrência (campo obrigatório);

• cnpj: CNPJ do lojista;

• number: Número da NF (campo obrigatório);

• serie: Número de série da NF (campo obrigatório);

• issuedAt: Data da emissão da NF;

• accessKey: Número da chave de acesso à NF (campo obrigatório);

• linkXml: URL para consulta da NF;

• linkDanfe: URL para consulta da DANFE.

2ª requisição - Endpoint responsável pela emissão das etiquetas de envio:

• Base URL: https://api-mktplace.viavarejo.com.br/api/v2

• Endpoint: /orders/{​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​orderId}​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​/generate-label

• Headers: client_id, access_token e orderId

• Method: POST

• Link Dev Portal: Clique aqui

Payload:

​

Confira o detalhamento:

• labelsNumber: Indica a quantidade de etiquetas por pedido;
  link: Indica o retorno em link ou Base64.
   

Fica a dica
Caso tenha alguma dúvida, entre em contato com nosso time através do e-mail integracao.mktp@viavarejo.com.br e informe o nome da APP e o Client_ID.