www.spartoo.pt
Atualização de uma encomenda
URL do Webservice : https://sws.spartoo.pt/mp/xml_maj_orders.phpEste webservice serve para atualizar o estatuto de uma encomenda.
Passagem da encomenda ao estatuto 2 (Encomenda em curso de preparação) : A encomenda é considerada como aceite. As informações da encomenda (nome, morada de entrega, transportadora, etc ... ) já não podem ser modificadas.
Passagem da encomenda ao estatuto 3 (Encomenda expedida) : O stock é considerado como retirado do fluxo. A encomenda foi entregue à transportadora. O código de tracking está disponível.
Passagem da encomenda ao estatuto 41 (Encomenda anulada) : Encomenda anulada, o cliente não receberá a mesma. O reembolso do cliente será efetuado em breve. Passagem da encomenda ao estatuto 45 (Encomenda enviada) : A encomenda foi perdida.
Passage de la commande en statut 47 (Encomenda enviada) : A entrega não pôde ser feita (destinatáio mudou-se, encomenda não levantada,...).
É possível passar uma encomenda ao estatuto 3, apenas quando a encomenda estiver em estatuto 2.
É possível passar uma encomenda ao estatuto 41, apenas quando a encomenda não estiver em estatuto 3 ou 41.
É possível passar uma encomenda ao estatuto 45, apenas quando a encomenda estiver em estatuto 3.
É possível passar uma encomenda ao estatuto 47, apenas quando a encomenda estiver em estatuto 3.
O tracking da encomenda efetua-se no momento em que a encomenda passa ao estatuto 3. É preciso indicar então o parâmetro tracking_number.
Um e-mail com o link de tracking será enviado ao cliente para o avisar que a encomenda foi enviada.
> Ver a lista dos estatutos das encomendas
Lista dos parâmetros
| Parâmetro | Descrição |
|---|---|
| partenaire | Deve conter a sua identificação: |
| oID | Identificação da encomenda a atualizar |
| statut | Novo estatuto da encomenda ( 2, 3 ou 41 ) |
| tracking_number | Número de tracking da transportadora ( a indicar quando a encomenda passa em estatuto 3 ) |
<root> <parcel> <tracking>string</tracking> <products> <product> <products_reference>string</products_reference> <products_size>string</products_size> </product> </products> </parcel> </root>
Exemple :
<root> <parcel> <tracking>12563AF256</tracking> <products> <product> <products_reference>basket_model_7</products_reference> <products_size>36</products_size> </product> <product> <products_reference>basket_model_7</products_reference> <products_size>37</products_size> </product> </products> </parcel> <parcel> <tracking>12563AF257</tracking> <products> <product> <products_reference>tshirt_blue_268</products_reference> <products_size>M</products_size> </product> </products> </parcel> </root>
Lista dos códigos de erros do webservice
| Código | Descrição |
|---|---|
| 1 | Sem erros nos parâmetros |
| -1 | O parâmetro partenaire não passou no parâmetro ou está vazio |
| -2 | O parâmetro do parceiro não existe |
| -5 | Falta o parâmetro rID ou o parâmetro statut |
| -6 | A devolução não foi encontrada, verifique o parâmetro rID ou o parâmetro do parceiro. |
| -8 | Erro na indicação do número de tracking |
| -9 | O novo estatuto é idêntico ao estatuto atual |
| -10 | O novo estatuto não existe |
| -11 | O parâmetro xml não passou no parâmetro ou está vazio |
| -14 | O produto não foi encontrado na nossa base de dados |
| -17 | Encomenda crossdock: o número da embalagem é obrigatório |
| -19 | Problema na cronologia da encomenda
|
| -26 | A encomenda apresenta um pedido de devolução, portanto não pode ser declarada como perdida |
| -27 | A encomenda já foi cancelada |
| -28 | Encomenda não encontrada |
| -29 | Erro desconhecido (perda / mudou-se) |
| -30 | A encomenda é muito antiga para ser atualizada para o estado 3. Contacte o serviço Marketplace. |
| -428 | A sua conta foi desativada. Não pode mais efetuar chamadas ao webservice |
| -429 | Efetuou demasiado chamadas para o Webservice nesta hora corrida |