Introdução
A API de solicitação de coleta permite que você verifique a disponibilidade de coleta, agende um entregador e cancele uma solicitação de coleta
A API de solicitação de coleta é aplicável a pacotes novos ou processados anteriormente em todas as regiões para remessas FedEx Express e FedEx Ground (envio e devolução). Este guia detalhado mostrará tudo o que você precisa saber sobre essa API.
Detalhes da API de solicitação de coleta
Os recursos essenciais associados à API de solicitação de coleta são:
Disponibilidade de coleta
Com esse recurso, você pode conferir a disponibilidade do serviço de coleta com base na solicitação de entrada. A disponibilidade de coleta depende de dois fatores: o horário limite e o tempo de acesso.
Horário limite: o último horário permitido para que uma coleta seja agendada, na hora local do código postal da coleta.
Tempo de acesso: o tempo entre o horário de coleta pronta (quando o pacote está pronto para ser coletado) e o horário em que o motorista está pronto para coletar o pacote.
Criar coleta
Essa opção permite que você agende uma coleta e é aplicável a remessas FedEx Express® e FedEx Ground® nacionais e internacionais. A API de solicitação de coleta dos serviços FedEx Ground e Express retorna um número de confirmação para a coleta agendada. A solicitação de coleta no Express retorna também um código de local. Você também pode agendar uma coleta para uma remessa de devolução usando essa API.
A linha de endereço do destinatário adicional (Linha de endereço 3) permite que você forneça dados de localização mais completos e precisos para agilizar a entrega de remessas FedEx Express®. Você pode economizar tempo e esforço agendando a coleta de suas remessas por um entregador da FedEx na sua localidade ou em outra localidade por uma taxa extra.
Cancelar coleta
Essa opção permite que você cancele uma coleta agendada anteriormente. Essa opção é aplicável a remessas FedEx Express e FedEx Ground nacionais e internacionais. Coletas FedEx Express nacionais e internacionais podem ser canceladas no mesmo dia. Remessas FedEx Ground nacionais e internacionais estarão disponíveis para cancelamento 24 horas depois do envio da solicitação de coleta. Se a remessa já tiver sido coletada, entre em contato com o serviço de atendimento ao cliente FedEx no telefone 3003.3339 (capitais e regiões metropolitanas) ou 0800.703.3339 (demais localidades) para realizar o cancelamento.
Detalhes da solicitação de coleta
Solicitações de coleta FedEx Express
- O horário em que seus pacotes estarão prontos para a coleta não deve ser posterior ao tempo limite do código postal da sua localidade. O tempo limite pode ser conferido na solicitação de disponibilidade de coleta.
- O tempo entre o pacote estar pronto e o horário em que o entregador não poderá mais entrar no local especificado para coletar o pacote não deve ser menor do que o "tempo de acesso", que também pode ser verificado na solicitação de disponibilidade de coleta.
- As coletas FedEx Express podem ser agendadas para o dia atual ou para o próximo dia útil.
- O número máximo de pacotes por solicitação de coleta única é 99.
- Se você já tiver uma coleta agendada regular, não precisará marcar uma coleta única ou adicionar outra coleta agendada regular.
- Não é possível alterar uma solicitação de coleta. Para alterar a solicitação, você terá que cancelar a solicitação original e fazer uma nova.
- Os sistemas da FedEx agora são compatíveis com a funcionalidade de coleta no Reino Unido.
Por exemplo, PT4H0M indica que o tempo de coleta é de 4 horas e 0 minutos.
Solicitações de coleta do FedEx Ground
- A coleta pode ser agendada para o próximo dia útil ou para qualquer dia útil com duas semanas de antecedência.
- O número máximo de pacotes por solicitação de coleta única é 99.
- Se você já tiver uma coleta agendada regular, não precisará marcar uma coleta única ou adicionar outra coleta agendada regular.
- A coleta em endereços residenciais está disponível com o pagamento de uma sobretaxa adicional.
- Não é possível alterar uma solicitação de coleta. Para alterar a solicitação, você terá que cancelar a solicitação original e fazer uma nova.
Tipos de serviço da API de solicitação de coleta
Coleta da FedEx Express
Uma cobrança de coleta por entregador é aplicada quando você solicita uma coleta FedEx Express, inclusive para solicitações feitas no site fedex.com ou no serviço de atendimento ao cliente FedEx.
Coleta do FedEx Ground
O FedEx Ground oferece serviço de coleta mediante solicitação com uma cobrança adicional. Para clientes com coleta agendada regular, calculamos a taxa de coleta semanal para o número da conta associado à coleta regular.
- Para clientes que não têm uma coleta agendada regular, calculamos uma cobrança de coleta por pacote mediante solicitação. As cobranças de coleta mediante solicitação não serão aplicadas se você entregar o pacote em uma localidade FedEx. Além disso, as cobranças de coleta mediante solicitação não são aplicadas para coletas com etiqueta de devolução impressa do FedEx Ground® Economy (anteriormente conhecido como FedEx SmartPost®), etiqueta de devolução por e-mail do FedEx Ground® Economy (anteriormente conhecido FedEx SmartPost®) e do programa de devoluções de pacotes do FedEx Ground®.
- No caso de clientes de coleta agendada regular, o FedEx Ground oferece um serviço de coleta mediante solicitação de um endereço diferente da localidade de envio do número da conta FedEx Ground. Para esse serviço, aplica-se uma cobrança adicional de coleta em endereço alternativo por endereço único por semana.
FedEx Extra Hours
Os serviços FedEx Extra Hours estão disponíveis para coleta com trânsito de um dia durante a noite de segunda a sexta-feira, permitindo que varejistas atendam pedidos do fim de tarde com entrega local no dia seguinte usando o serviço FedEx Express.
Para obter mais informações sobre os serviços disponíveis, visite fedex.com.
Como a API de solicitação de coleta funciona
As opções de coleta disponíveis com a API de solicitação de coleta são:
Verificar disponibilidade de coleta
Use este endpoint para solicitar os detalhes do cronograma de coleta disponível.
As informações essenciais associadas a esta solicitação são:
- Detalhes do endereço de coleta
- Tipo de solicitação de coleta (por exemplo: mesmo dia/dia futuro)
- Transportadora FedEx para coleta (por exemplo, Express/Ground)
- Se é uma coleta doméstica/internacional
A resposta bem-sucedida a essa solicitação retornará os detalhes do cronograma de coleta disponível, como a hora limite da coleta, a data da coleta, a hora de acesso da coleta, a hora padrão em que a coleta estará pronta e outros detalhes sobre o cronograma de disponibilidade da coleta. Ela também retorna erros e descrições em caso de falhas.
Criar coleta
Use este endpoint para criar uma solicitação de coleta para que um pacote seja coletado.
As informações essenciais associadas a esta solicitação são:
- O número da conta FedEx que será faturada para a coleta
- Dados da origem (endereço, localidade e tipo de endereço de coleta, como conta/remetente/outro)
- Transportadora FedEx para coleta (Express/Ground)
- Detalhes do endereço da conta associada
A solicitação de coleta bem-sucedida retornará um número de confirmação de coleta, notificação de coleta e código de local para a coleta sendo agendada. Ela também retorna erros e descrições em caso de falhas.
Cancelar coleta
Use essa solicitação para cancelar uma solicitação de coleta já agendada para um pacote.
As informações essenciais associadas a esta solicitação são:
- Código de confirmação da coleta (obtido ao enviar uma solicitação de coleta)
- Transportadora FedEx para coleta (Express/Ground)
- Data agendada (data em que o despacho de coleta ocorre)
- Localidade (a localidade FedEx Express responsável por processar a solicitação de coleta)
O cancelamento de coleta bem-sucedido retornará um número de confirmação e uma mensagem de confirmação de cancelamento da coleta. Ela também retorna erros e descrições em caso de falhas.
Observação: envie o número de confirmação de coleta e o código de localidade correspondente (aplicável apenas para FDXE) para cancelar a coleta agendada. As informações do número de confirmação da coleta e o código de localidade correspondente (aplicável apenas a FDXE) são obtidas ao enviar uma solicitação de coleta. Uma notificação de falha será enviada se você tentar cancelar uma coleta depois que o entregador FedEx tiver sido enviado para o local de coleta.
Regras do negócio
- Para solicitar uma coleta em um país diferente, inclua o elemento de país com o código de país adequado do local onde você quer que a FedEx colete sua remessa.
- A FedEx informará um número de confirmação para uma solicitação de despacho bem-sucedida. Solicitações de despacho devem ser limitadas a uma por dia, a menos que seus pacotes ultrapassem as dimensões e peso da solicitação original.
- Solicitações de despacho poderão falhar se você inserir um período curto demais entre o pacote estar pronto e o fechamento do ponto de coleta. Se tiver dúvidas sobre os horários de coleta, entre em contato com a linha direta de suporte FedEx na sua região.
- A API de solicitação de reserva é compatível com os tipos de peso ″LB″ e ″KG″. A unidade de peso do pacote e da mercadoria devem ser iguais, caso contrário a solicitação apresentará um erro.
- Se você precisar agendar uma coleta para pacotes FedEx Express (incluindo remessas dentro do México) e FedEx Ground, será necessário agendar uma coleta para cada uma dessas transportadoras individualmente.
- Se sua localidade de coleta ficar em uma área remota, certifique-se de que os pacotes estão prontos mais cedo para acomodar o cronograma de coleta remota.
- Sempre inclua o último horário em que o pacote pode ser coletado (ou o horário de fechamento da sua empresa).
- O serviço de coleta aos sábados é oferecido em localidades selecionadas em todo o mundo para seus pacotes FedEx Express. A entrega aos sábados também está disponível em várias localidades FedEx. Use o endpoint de serviço de localidades para receber uma lista das localidades com entrega aos sábados.
- Para coletas FedEx Ground e FedEx Express, você pode solicitar um endereço de coleta alternativo que não seja a localidade de envio vinculada ao seu número de conta FedEx.
- Se quiser utilizar um serviço de coleta regular FedEx Express ou FedEx Ground, entre em contato com seu executivo de contas FedEx.
- Você só poderá cancelar uma coleta FedEx Express ou FedEx Ground se:
- O horário em que o pacote estará pronto não tiver passado, e
- O entregador não tiver sido enviado para fazer a coleta
Coleção JSON API
Response