Guias de uso
Documentação GlobalDeveloper HubSuporteStatus da API

Fulfillment

Suggest Edits

Este feed permite a atualização à Amazon com informações de envio dos pedidos.

A Amazon publica essas informações na conta do comprador para que ele possa verificar o status do envio. Depois que o vendedor enviar o pedido, submeta este feed, com confirmação de envio do pedido.

Se o pedido possui um método de envio rastreável, inclua o número de rastreamento no feed. Este feed é importante porque sinaliza à Amazon para cobrar do comprador e creditar na conta do vendedor no Marketplace Payments e notificar o comprador de que o pedido está a caminho.

Se a Amazon não receber a confirmação dentro de 30 dias após o pedido ter sido feito, o pedido será
cancelado automaticamente e o vendedor não receberá o pagamento pelo pedido. Mais
informações neste link.

Configuração do XML

Parâmetros obrigatórios:

  • AmazonOrderID (ou MerchantOrderID)
  • FulfillmentDate
  • ShipperTrackingNumber

Throttling inicial:

  • Rate: 1 request/121 segundos
  • Burst: 15

Método HTTP: POST

Product Type: POST_ORDER_FULFILLMENT_DATA

Path: /feeds/2020-09-04/feeds

EndPoints: https://sellingpartnerapi-na.amazon.com

Headers:

  • Authorization
  • host
  • x-amz-access-token
  • x-amz-date
  • user-agent

Parâmetros

ParâmetroObrigatoriedadeDescriçãoValores esperados
AmazonOrderId/
MerchantOrderID		Obrigatório ID do pedido (pode ser tanto o OrderID fornecido pela Amazon, quanto o ID do vendedor - desde
que este último tenha sido informado no
OrderAcknowledgement)		string
MerchantFulfillmentIDOpcionalCódigo do FC do vendedorstring
FulfillmentDateObrigatórioData do envio do pedido. Precisa
estar no formato ISO 8601
(e.g. AAAA-MM-DDTHH:MM:SSZ)		Data no formato ISO
8601
CarrierCodeObrigatórioCódigo da transportadora
(disponível aqui):
Correios, DirectLog, Total Express,
TransFolha, FedEX, SFC, YANWEN,
DHL, DHL eCommerce, Hongkong
Post, 4PX, SF Express, Royal Mail,
India Post, China Post, Other		string
CarrierNameObrigatório caso
"Other"
Retornar uma string com o nome
da transportadora, caso ela não
esteja disponível na lista de
CarrierCode		string
ShippingMethodOpcionalAqui deve-se indicar se a entrega é
padrão ou expressa. Essa
informação já foi passada via API
de getOrders, no parâmetro
ShipmentServiceLevelCategory		ShipmentServiceLevel
Category
ShipperTrackingNumberObrigatórioTracking number do pedido/item
sendo enviado		string
AmazonOrderItemCode/ MerchantFulfillmentItemIDOpcionalID do item pedido (pode ser tanto o ID fornecido pela Amazon, quanto o ID do vendedor - desde
que este último tenha sido informado no
OrderAcknowledgement)		string
QuantityOpcionalQuantidade de itens que está sendo enviadaInteger

🚧

IMPORTANTE1: CarrierCode será validado pela Amazon

Os códigos de transportadores estão disponíveis neste link (por enquanto, a consulta não está disponível via API – é feita manualmente). O desenvolvedor deve cruzar o dado que o vendedor está fornecendo com o dado que está disponível no link. Caso haja o ‘match’, retornar na API exatamente o nome da transportadora da mesma forma que está disponível no link. Se nenhuma opção se adequa à lista, retornar ‘Other’.

🚧

IMPORTANTE2: CarrierName obrigatório caso CarrierCode = ‘Other’

Retornar o nome completo da transportadora caso você tenha preenchido Other no campo .

🚧

IMPORTANTE3: ShipperTrackingNumber será validado pela Amazon.

Se o tracking number for invalidado pela Amazon, ela irá retornar a seguinte mensagem

“The tracking ID tracking id for carrier name does not match the expected format for the carrier. Please verify that you have entered the tracking ID and carrier name correctly.”

Se o desenvolvedor receber essa mensagem, ele deve solicitor ao vendedor que informe novamente o Tracking Number para dar sequência ao fluxo. Não deve-se seguir com o fluxo de processamento de Orders até que o vendedor informe um tracking number que seja aceito pela Amazon.

🚧

IMPORTANTE 4: Data deve ser sempre posterior à data de criação do pedido.

O campo FulfillmentDate deve ser sempre após a criação do pedido, datas inferiores retornaram erro.

Confirmação de envio de 2 pedidos no mesmo Feed

Exemplo de Request 

<?xml version="1.0" encoding="UTF-8"?>
<AmazonEnvelope
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
	<Header>
		<DocumentVersion>1.02</DocumentVersion>
		<MerchantIdentifier>A2ZPJ4TLUOSWY8</MerchantIdentifier>
	</Header>
	<MessageType>OrderFulfillment</MessageType>
	<Message>
		<MessageID>1</MessageID>
		<OrderFulfillment>
			<AmazonOrderID>702-6222826-7235464</AmazonOrderID>
			<FulfillmentDate>2021-06-21T09:11:36.000Z</FulfillmentDate>
			<FulfillmentData>
				<ShippingMethod>PAC</ShippingMethod>
				<ShipperTrackingNumber>PR521458953BR</ShipperTrackingNumber>
			</FulfillmentData>
		</OrderFulfillment>
	</Message>
	<Message>
		<MessageID>2</MessageID>
		<OrderFulfillment>
			<AmazonOrderID>702-5425596-8852242</AmazonOrderID>
			<FulfillmentDate>2021-06-21T10:50:59.000Z</FulfillmentDate>
			<FulfillmentData>
				<CarrierCode>Other</CarrierCode>
				<CarrierName>Transportadora Gerais LTDA</CarrierName>
				<ShippingMethod>Transportadora Gerais LTDA</ShippingMethod>
				<ShipperTrackingNumber>21458</ShipperTrackingNumber>
			</FulfillmentData>
		</OrderFulfillment>
	</Message>
</AmazonEnvelope>

Erro na construção do request: desenvolvedor enviou um pedido sem os parâmetros
obrigatórios para este Product Type

<AmazonEnvelope
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
	<Header>
		<DocumentVersion>1.02</DocumentVersion>
		<MerchantIdentifier>A3QR44KON2MLZ3</MerchantIdentifier>
	</Header>
	<MessageType>ProcessingReport</MessageType>
	<Message>
		<MessageID>1</MessageID>
		<ProcessingReport>
			<DocumentTransactionID>557342018675</DocumentTransactionID>
			<StatusCode>Complete</StatusCode>
			<ProcessingSummary MarketplaceName="www.amazon.com(http://www.amazon.com/)">
				<MessagesProcessed>1</MessagesProcessed>
				<MessagesSuccessful>0</MessagesSuccessful>
				<MessagesWithError>1</MessagesWithError>
				<MessagesWithWarning>0</MessagesWithWarning>
			</ProcessingSummary>
			<Result>
				<MessageID>12025257800</MessageID>
				<ResultCode>Error</ResultCode>
				<ResultMessageCode>18028</ResultMessageCode>
				<ResultDescription>The data you submitted is incomplete or invalid. For help fixing this, see http://sellercentral.amazon.com/gp/help/30721 (http://sellercentral.amazon.com/gp/help/30721%3C/ResultDescription)>
					<AdditionalInfo>
						<AmazonOrderID>112-5065868-6411459</AmazonOrderID>
					</AdditionalInfo>
			</Result>
		</ProcessingReport>
	</Message>
</AmazonEnvelope>

Updated about 3 years ago