Estávamos enfrentando um problema enquanto tentávamos criar uma remessa (Usando / shipments API) e depois disso fomos buscar o rótulo (Usando / shipments / {shipment_id} / files API). O problema foi que obtivemos resposta em branco. Quando verificamos as remessas no back office, parecia a imagem abaixo:
Quando clicamos na remessa (com status = "conceito"), recebemos uma mensagem como "A remessa foi criada, mas ainda não foi registrada na transportadora.“
Quando entendemos o conceito desse novo processo de criação de remessas no Spring Omni, ficamos sabendo que, na Spring Global, precisamos registrar uma remessa em vez de apenas criar a remessa antes de buscar a etiqueta correspondente à remessa. Existem dois cenários possíveis para registrar uma remessa:
- Crie o envio e registre-se ao mesmo tempo
- Crie a remessa, mas registre-a em um horário específico, ou seja, no futuro
1. Para registrar uma remessa instantaneamente
Ao enviar a solicitação de envio de criação, precisamos enviar o "register_at"valor do parâmetro como 0 ou tempo passado (timestamp do UNIX) nos dados da solicitação. Por favor, consulte o código abaixo para o mesmo:
{ "data": { "type": "shipments", "attributes": { "recipient_address": { "street_1": "Baker Street", "street_2": "Marylebone", "street_number": 221, "street_number_suffix": "B", "postal_code": "NW1 6XE", "city": "London", "region_code": "ENG", "country_code": "GB", "first_name": "Sherlock", "last_name": "Holmes", "company": "Holmes Investigations", "email": "s.holmes@holmesinvestigations.com", "phone_number": "+31 234 567 890" }, "return_address": { "street_1": "Baker Street", "street_2": "Marylebone", "street_number": 221, "street_number_suffix": "B", "postal_code": "NW1 6XE", "city": "London", "region_code": "ENG", "country_code": "GB", "first_name": "Sherlock", "last_name": "Holmes", "company": "Holmes Investigations", "email": "s.holmes@holmesinvestigations.com", "phone_number": "+31 234 567 890" }, "sender_address": { "street_1": "Baker Street", "street_2": "Marylebone", "street_number": 221, "street_number_suffix": "B", "postal_code": "NW1 6XE", "city": "London", "region_code": "ENG", "country_code": "GB", "first_name": "Sherlock", "last_name": "Holmes", "company": "Holmes Investigations", "email": "s.holmes@holmesinvestigations.com", "phone_number": "+31 234 567 890" }, "pickup_location": { "code": "205604", "address": { "street_1": "Baker Street", "street_2": "Marylebone", "street_number": 221, "street_number_suffix": "B", "postal_code": "NW1 6XE", "city": "London", "region_code": "ENG", "country_code": "GB", "first_name": "Sherlock", "last_name": "Holmes", "company": "Holmes Investigations", "email": "s.holmes@holmesinvestigations.com", "phone_number": "+31 234 567 890" } }, "description": "Order #8008135", "physical_properties": { "height": 150, "width": 300, "length": 500, "volume": 22.5, "weight": 5000 }, "items": [ { "sku": "123456789", "description": "OnePlus X", "item_value": { "amount": 995, "currency": "EUR" }, "quantity": 2, "hs_code": "8517.12.00", "origin_country_code": "GB", "item_weight": 135 } ], "customs": { "content_type": "merchandise", "invoice_number": "9000", "non_delivery": "return", "incoterm": "DAP", "license_number": "218532158", "certificate_number": "12122121" }, "register_at": 0 }, "relationships": { "service_options": { "data": [ { "type": "service-options", "id": "4c675b1a-516c-4410-abff-d237fd45bcd0" } ] }, "shop": { "data": { "type": "shops", "id": "35eddf50-1d84-47a3-8479-6bfda729cd99" } }, "service": { "data": { "type": "services", "id": "175a235f-aff5-4e44-87b5-3657b75c1deb" } }, "contract": { "data": { "type": "contracts", "id": "2cb32706-5762-4b96-9212-327e6afaeeff" } } } } }
Se enviarmos o valor register_at como timestamp atual, poderemos ter algum atraso no registro da remessa, a So Spring Global sugeriu que enviássemos o valor register_at como 0 para que a hora fosse considerada no passado e a remessa fosse registrada assim que que possível. Como o envio será registrado agora, não poderemos excluir / editar o mesmo.
2. Registre uma remessa no futuro
Se quisermos editar / excluir a remessa depois de criar a remessa, só precisaremos registrar a remessa no futuro ou em um horário específico. Para registrar uma remessa no futuro, digamos que após 5 horas de criação da remessa, simplesmente passe o valor "register_at" como data e hora futura de cinco horas com base na hora atual. Agora poderemos editar / excluir a remessa até 5 horas, mas não poderemos buscar o rótulo e a fatura comercial. No momento, a remessa será registrada automaticamente e poderemos buscar o rótulo e a fatura comercial após o tempo determinado.
Então, essas são as duas maneiras de registrar a remessa. Nós podemos usar ambos com base em nossa exigência
Por favor, visite aqui para informações relacionadas:
Erro Spring Global (Spring Omni): A propriedade phone_number é necessária
Manifestação Omni da Primavera
Erro Spring Global (Spring Omni): O envio não está sendo registrado