Gerar de etiquetas de envio

Este endpoint permite que o vendedor (seller) gere etiquetas de envio para uma entrega específica. A etiqueta de envio é um documento que contém informações sobre o destinatário, remetente, transportadora e detalhes do pedido, facilitando o processo de logística e entrega.

Após a geração de uma etiqueta de envio, o vendedor deve imprimir o documento e anexá-lo à embalagem do produto, garantindo que a entrega seja realizada corretamente.

Escopo requerido

Valor	Descrição
`order-delivery:write`	Permite a escrita de entregas e dados relacionados.

Parâmetros da URL

Campo	Tipo	Descrição	Obrigatório
`id`	ObjectId	ID da entrega na plataforma.	Sim

Corpo da requisição

O corpo da requisição deve conter os seguintes campos:

Campo	Tipo	Descrição	Obrigatório
`invoice`	string	Chave da nota fiscal associada.	Sim
`pickup_company`	integer	ID do ponto de coleta selecionado.	Não

Observação: O campo pickup_company é opcional e deve ser informado caso o vendedor deseje escolher um ponto de coleta específico. Caso contrário, a plataforma Eu Preciso escolherá automaticamente o ponto de coleta mais próximo ao gerar a etiqueta de envio.

{
  "invoice": "35191012345678000155550010000000012345678903",
  "pickup_company": 1529
}

Chamada:

POST /v1.0/marketplace/orders/deliveries/{id}/labels \
Host: apps.eupreciso.com.br \
Authorization: Bearer {access_token} \
Content-Type: application/json \

Resposta:

{
  "id": "6712a312c37c38e9038fd9b6",
  "label_id": "f7b3b2b4-4b7d-4b7d-8b7d-4b7d8b7d8b7d",
  "status": "released",
  "created_at": "2024-11-15T14:25:37Z",
  "url": "https://apps.eupreciso.com.br/minhasvendas/pedido/6712a312c37c38e9038fd9b6/imprimir",
  "files": {
    "pdf": "https://example-bucket.s3.amazonaws.com/pdf/example-pdf-1.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=EXAMPLECREDENTIAL%2F20241027%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20241027T161017Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=example-signature-1",
    "zpl": "https://example-bucket.s3.amazonaws.com/zpl/example-zpl-1.zpl?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=EXAMPLECREDENTIAL%2F20241027%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20241027T161017Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=example-signature-2",
    "jpeg": "https://example-bucket.s3.amazonaws.com/example-jpeg-1.jpeg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=EXAMPLECREDENTIAL%2F20241027%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20241027T161017Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=example-signature-3"
  },
  "tracking_number": "1234567890",
  "melhor_envio_tracking": "ME1234567890",
  "invoice": {
    "key": "35191012345678000155550010000000012345678903",
    "issued_at": "2024-07-22T15:23:17.000Z",
    "xml": "<xml>...</xml>",
    "status": "approved"
  },
  "pickup_company": {
    "id": 1529,
    "name": "[DROPIT] - MaxTools Ferramentas - Ponto de Coleta",
    "initials": "SP",
    "address": {
      "street": "Rua dos Bolos",
      "number": "0",
      "complement": "Sala 101",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "zip_code": "01005-000",
      "latitude": -23.5505199,
      "longitude": -46.6333094
    }
  }
}

Pontos de coleta Adicionar nota fiscal a uma entrega