Español
English
Català
Quem pesquisa «api mrw» costuma ter umas credenciais acabadas de receber da sua franquia, ou um Odoo a partir do qual quer deixar de copiar moradas para o portal da MRW. Aqui fica o que é, que chamadas importam e onde falha, segundo o código do nosso conector MRW para Odoo.
O que é a API da MRW: Sagec, SOAP e credenciais da sua franquia
O serviço web com que a MRW regista envios chama-se Sagec e fala SOAP: envelopes XML com cabeçalho de autenticação, não JSON com um token. Tem um endereço de testes (sagec-test.mrw.es) e outro de produção (sagec.mrw.es). As credenciais não saem de um portal de programadores: são-lhe dadas pela sua franquia. São o código de franquia, o número de cliente, o departamento se o utilizar, o utilizador e a palavra-passe.
As chamadas que importam são poucas: TransmEnvio regista o envio (TransmEnvioInternacional fora de Espanha), GetEtiquetaEnvio devolve a etiqueta e CancelarEnvio anula-o.
A etiqueta sai ao validar a guia
No Odoo, a MRW instala-se como mais um método de envio. Ao validar a guia, o conector regista o envio, guarda o número na guia e anexa a etiqueta em PDF; se a MRW não devolver o ficheiro, usa o URL da etiqueta presente na resposta. Um assistente faz o mesmo com várias guias de uma só vez.
Antes do primeiro envio, é preciso decidir o que acontece se a MRW falhar: bloquear a validação, e a guia não se fecha sem etiqueta, ou validar e deixar o envio pendente com um aviso. O que já vem resolvido: se a guia tiver número de envio, não se regista outro, pelo que uma nova tentativa não deixa duas etiquetas.
Rastreio: o que tem e o que não tem
O número de envio é escrito no campo de rastreio padrão do Odoo: chega ao cliente no e-mail de confirmação de entrega, se o tiver ativado, e um botão da guia abre o rastreio da MRW. Para a maioria das lojas, chega.
O que o conector não faz hoje é trazer para o Odoo cada mudança de estado: em distribuição, entregue, incidência. Se precisar disso, por exemplo para abrir uma tarefa perante uma incidência de entrega, é um desenvolvimento à medida, e começa por confirmar o que lhe dá o seu contrato com a MRW.
Recolhas: a data viaja com cada envio
A recolha física é organizada pela sua franquia, de acordo com o seu contrato. O Odoo envia em cada envio a data de recolha e os dados de origem, que são os da sua empresa. O conector calcula a data a partir da prevista na guia: nunca no passado, a partir das 17:00 passa-a para o dia seguinte e salta os fins de semana. Se a sua franquia tiver outra hora limite, confirme com ela.
E se o código postal ou o telefone da sua empresa estiverem errados no Odoo, não falha um envio: falham todos.
Os erros de morada que mais travam envios em Espanha
Das rejeições por dados, as de morada dependem de si e não do contrato. Cinco a vigiar:
- Código postal de quatro algarismos. Os de Álava, Albacete, Alicante, Almería, Ávila, Badajoz, Baleares, Barcelona e Burgos começam por zero, e esse zero desaparece quando a base de clientes passa por uma folha de cálculo: 08001 passa a 8001.
- Rua sem número. A MRW separa via, número e restante; o Odoo guarda a rua numa só linha. O conector divide-a e, se não encontrar algarismo, envia «S/N». As ruas com número no nome, como «Calle 8 de Marzo», nenhuma divisão automática as acerta sempre: são as primeiras a verificar.
- Telefone do destinatário vazio ou incompleto. A MRW exige-o; a validação prévia assinala qualquer telefone com menos de nove algarismos.
- Localidade ou província vazias. Acontece com contactos criados a partir do site ou importados a meio; no Odoo, um código postal correto não preenche a província.
- Peso zero. Se os artigos não têm peso, a guia também não. Existe um peso por defeito configurável, mas com volumes pesados choca com o máximo por volume do serviço.
Para não o descobrir com a carrinha à porta, o método de envio traz um botão de validação prévia: verifica credenciais, serviço, dados da sua empresa, peso por defeito e até vinte guias abertas, à procura precisamente destas falhas. E se a MRW rejeitar um envio, o conector traduz a resposta num motivo legível.
Corrija a morada na ficha do contacto de entrega e relance o envio a partir da guia: como não chegou a ser registado, nada se duplica.
Quando não precisa do nosso conector
Se regista um punhado de envios por semana, o portal da MRW chega e nenhuma integração compensa. Se usa o Odoo 19 e só precisa de etiqueta e rastreio, veja primeiro o módulo delivery_mrw da OCA: é gratuito e, ao contrário do nosso, já envia a cobrança. O que não traz é validação prévia, novas tentativas nem data de recolha calculada. Comparação completa em que transportadora escolher para o Odoo.
O que faz o nosso conector
O conector MRW para Odoo faz o descrito: envio e etiqueta ao validar, rastreio, cancelamento com CancelarEnvio, data de recolha, validação prévia e novas tentativas. Funciona no Odoo 17, 18, 19 e 20. Se não tem Odoo mas um site próprio, veja integrar a API de uma transportadora num site próprio.
Perguntas frequentes
Preciso de contrato com a MRW para usar a sua API?
Sim. As credenciais do Sagec são-lhe dadas pela sua franquia MRW. O conector traz separados o endereço de testes e o de produção, e um botão para verificar a ligação antes do primeiro envio real.
É possível enviar à cobrança?
Com o nosso conector, hoje não: os envios são registados sem cobrança. O módulo MRW da OCA envia-a. Se vende à cobrança com a MRW e precisa também do resto, é uma ampliação avaliada à parte.
O que acontece se a API da MRW não responder?
Se a falha for da MRW (tempo de espera, erros 5xx ou «error interno»), o conector agenda novas tentativas aos 5, 15, 30, 60, 180 e 360 minutos, seis no máximo por defeito. Se a falha for de dados, não volta a tentar: mostra-lhe o motivo.
Ligações úteis dentro da FlexigoTech
O que fazemos sobre isto
A MRW rejeita-lhe envios ou continua a copiar moradas à mão?
Diga-nos que versão do Odoo usa, quantos envios faz por dia e que erro lhe devolve a MRW. Dizemos-lhe se é um dado, o contrato ou a integração, e se lhe basta o módulo da OCA. Escreva para comercial@flexigobe.com ou agende uma chamada.