Introdução
A API de Validação de Códigos Postais FedEx permite que os clientes FedEx validem os códigos postais e obtenham os compromissos de serviço. Suporta cidade, código postal, país, pesquisas e validações relacionadas com origem e destino. Devolve os detalhes de localização e código postal verificados na resposta.
Detalhes da API de Validação de Códigos Postais
A Validação de Códigos Postais valida os códigos postais de países e cidades e fornece um código postal sem erros como resposta. São necessários os códigos postais formatados corretamente para processar uma expedição ou criar etiquetas de expedição.
Esta API utiliza as informações introduzidas como a data de expedição, código postal, indicativo de país e outras informações, e verifica a existência de inconsistências entre os valores de estado e cidade. A Cidade e o Estado são definidos se for encontrada uma inconsistência e se o país for os EUA ou Canadá. Por exemplo: FDXE – FedEx Express®, FDXG – FedEx Ground® e FXSP – FedEx Ground® Economy (Anteriormente denominada Fedex SmartPost ®). A API valida a entrada dada e fornece detalhes da localização e o código postal sem erros.
A FedEx suporta serviços para países com código postal e países sem código postal.
Países com código postal
As expedições para estes países devem incluir os códigos postais nas cartas de porte e outra documentação para ajudar a reduzir os atrasos e maximizar a eficiência. Os clientes FedEx Express devem incluir códigos postais válidos nos endereços para os destinatários localizados nos países abaixo.
Para obter mais informações sobre países com código postal, consulte Países com Código Postal.
Países sem código postal
Como o nome sugere, existem países sem código postal suportados pela FedEx que não exigem códigos postais nas suas expedições. O código do estado ou nome da cidade é suficiente quando o cliente expede para um país sem código postal. Se ocorrer um erro de validação num país que não utilize códigos postais, tente forçar o endereço ao introduzir \"00000\" como código postal de substituição. A utilização deste código postal falso não deve causar problemas, pois não existe.
Seguem-se os benefícios de utilizar a API de Validação de Códigos Postais FedEx:
- Reduz os atrasos das expedições e aumenta a eficiência.
- Aumenta o número de entregas pontuais e completas.
- Melhora o serviço FedEx em áreas urbanas ao permitir uma flexibilidade na hora limite e nos horários de recolha.
Como funciona a API de Validação de Códigos Postais
A Validação de Códigos Postais FedEx utiliza o ponto final abaixo para validar os códigos postais em cidades, países, origem e destino. A secção seguinte descreve as principais entradas e respostas do ponto final:
Validar Código Postal
Este pedido é utilizado para devolver detalhes do código postal, código postal sem erros e descrição da localização com base nos detalhes introduzidos. As informações-chave introduzidas e associadas a este pedido são as seguintes:
- carrierCode
- countryCode
- stateOrProvinceCode
- postalCode
- shipDate
O resultado bem-sucedido deste pedido é locationdetails e cleanedpostalcode na entrada fornecida. O pedido não será efetuado se o código postal não for válido. Por exemplo, se a combinação Indicativo de País, Estado/Província e Código Postal não for válida.
Esclarecimento de Equívocos Comuns
- Não é possível fazer uma referência cruzada do alinhamento do território com o alinhamento do código postal porque são resultados de processos de alinhamento distintamente separados.
- Nem todas as localizações geográficas no mundo têm códigos postais.
Para obter mais informações sobre a lista de Serviços Específicos da Região, consulte a Lista de Serviços Específicos da Região.
Regras Empresariais
- Combinação de número, nome da rua, etc. É necessária, pelo menos, uma linha de um endereço físico válido. As linhas vazias no endereço não são permitidas.
- É necessário o estado (2 letras) ou o código da província se o país destinatário for os EUA ou Canadá, ou se a EEI se aplicar e o país for o México {MX}.
- Os dados descritivos de uma localização física podem ser utilizados como endereço físico real (local para onde se pode ir) ou como contentor de \"partes de endereço\" que deve ser tratado como unidade (como a combinação de cidade, estado e código postal nos EUA).
- O formato e a presença do campo de código postal irá variar consoante o país.
Recolha da API JSON
Response