Criar e fazer upload de faturas
Saiba como criar e fazer upload de faturas com e sem inscrição no VCS.
Depois de se inscrever no VCS, você tem duas opções para criar e fazer upload de faturas:
- Permita que a Amazon crie e envie automaticamente suas faturas.
- Uso Dados de cálculo de impostos da Amazon para criar suas próprias faturase, em seguida, carregue-os manualmente usando a SP-API.
Se não quiser usar o VCS, você pode usar seus próprios dados fiscais para criar faturas e, em seguida, enviá-las manualmente usando a SP-API ou por meio do Seller Central. Para obter instruções sobre como usar esse método, consulte Carregar faturas manualmente.
Dica
Não forneça informações de remessa do vendedor nas faturas, pois isso pode confundir os clientes. A Amazon coleta pagamentos diretamente dos clientes e desembolsa o valor aos vendedores.
Para obter informações sobre requisitos de conformidade de faturas e correções de faturas, consulte Conformidade e correção da fatura VCS.
Permita que a Amazon crie faturas para você
Essa opção está disponível para todos os vendedores que se inscreverem no Serviço de Cálculo do IVA (VCS) e selecionarem o I want Amazon to generate invoices on my behalf opção de obter acesso ao relatório de cálculo do IVA da Amazon. Esse relatório contém informações úteis sobre pedidos de VCS, incluindo: o número da fatura, o link da fatura, o IVA do comprador e informações de envio de/para envio. Os pedidos estão disponíveis neste relatório três dias após o envio. Use as informações na tabela a seguir para solicitar o relatório do VCS usando a API do parceiro de vendas (SP-API).
API | API de relatórios |
---|---|
Operation | createReport |
ReportType | SC_VAT_TAX_REPORT |
O Programa VCS afeta o conteúdo dos seguintes relatórios:
Relatórios de pedidos
Inclua o valor do IVA
Solicite os relatórios que você solicita depois você se inscreve no VCS aparece da seguinte forma:
ItemTax
(em relatórios XML) eitem_tax
(em relatórios de arquivo simples). Contém o valor do IVA, calculado pela Amazon.ItemPrice
(em relatórios XML) eitem_price
(em relatórios de arquivo simples). Contém o preço com IVA incluído.
O valor sem IVA é o preço do item menos o imposto do item.
Observação
Quando o imposto sobre o item é zero, 0% de IVA foi cobrado pela transação. Há várias circunstâncias em que isso pode acontecer. Os exemplos incluem transações internacionais e transações transfronteiriças B2B na UE. Para obter mais informações, consulte Metodologia de cálculo do VCS.
Incluir detalhes do IVA
Você pode optar por incluir atributos relacionados ao VCS em seus relatórios de pedidos.
Use o procedimento a seguir para incluir atributos relacionados ao VCS nos relatórios de pedidos:
-
Vá para Adicionar ou remover colunas do relatório de pedidos no Seller Central.
-
Adicione o VAT details coluna.
Depois de concluir esse procedimento, as seguintes colunas serão adicionadas aos seus relatórios de pedidos: Item price VAT exclusive, Shipping price VAT exclusive, e Gift wrap price VAT exclusive.
Relatórios de pedidos do programa Logística da Amazon
Relatórios de pedidos do FBA que você solicita depois você se inscreve no VCS aparece da seguinte forma:
ItemTax
(em relatórios XML) eitem_tax
(em relatórios de arquivo simples). Contém o valor do IVA, calculado pela Amazon.ItemPrice
(em relatórios XML) eitem_price
(em relatórios de arquivo simples). Contém o valor sem IVA (alterado do valor com IVA incluído).
O valor com IVA incluído é o preço do item mais o imposto do item.
Use os dados de cálculo de impostos da Amazon para criar faturas
Você só pode usar essa opção com a API do parceiro de vendas (SP-API) e você deve usar os dados fiscais fornecidos pela Amazon para criar suas faturas.
Etapa 1. Extraia os dados de cálculo de impostos de todos os seus pedidos do relatório de dados da fatura de IVA (VIDR).
O VIDR é um relatório que contém detalhes do cálculo do imposto no nível da transação e só está disponível para vendedores que se inscreveram no VCS. Esse relatório contém todas as informações necessárias para gerar uma fatura de IVA precisa para cada remessa, seja ela enviada pelo vendedor ou pela Amazon (FBA). Um pedido está disponível neste relatório imediatamente após o envio do pedido.
Use o createReport
operação com o GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT
ou GET_XML_VAT_INVOICE_DATA_REPORT
tipo de relatório (reportType
).
reportOptions
+ pendingInvoices
- all
.
-
pendingInvoices
: Um valor booleano. Quando nãoReportOption
o parâmetro é especificado, o padrão éReportOption=PendingInvoices
. Exemplo:"reportOptions": {"ReportOption=pendingInvoices": "true"}
- Quando
true
, o relatório contém somente remessas para as quais as faturas e notas de crédito estão pendentes. Esse relatório não contém remessas para as quais as faturas já tenham sido carregadas com sucesso. Isso inclui remessas de pedidos que foram feitos nos últimos 90 dias. - Quando
false
(ou se as faturas pendentes não estiverem incluídas em ReportOptions), o conteúdo do relatório depende do valor deall
.
Esses relatórios incluem detalhes da remessa de pedidos enviados com datas de pedidos nos últimos 90 dias, para os quais as faturas vencem e devem ser carregadas (todas as remessas em que o status da fatura é
InvoicePending
ouCreditNotePending
). Os relatórios com essa opção não incluem remessas para as quais as faturas já foram carregadas com sucesso. O objetivo dessa opção é permitir que o vendedor percorra todos os itens da linha e crie faturas, sem precisar aplicar sua própria lógica comercial. - Quando
-
all
: Um valor booleano. O padrão é. Exemplo:"reportOptions": {"ReportOption=All": "true"}
- Quando
true
, o relatório contém remessas de pedidos que foram feitos dentro do intervalo de datas especificado por você. Isso inclui remessas de todos os status de fatura possíveis. Você deve especificar ostartDate
eendDate
parâmetros para ocreateReport
operação. OdataStartTime
edataEndTime
os valores devem corresponder aos primeiros e últimos dias válidos no especificadoreportPeriod
. Por exemplo, quandoreportPeriod=WEEK
,dataStartTime
deve ser um domingo edataEndTime
deve ser um sábado. O intervalo de datas máximo permitido é de 30 dias. - Quando
false
, ou seall
não está incluído emreportOptions
, o conteúdo do relatório depende do valor dependingInvoices
. O valor padrão é"pendingInvoices" : "true"
.
Esses relatórios incluem remessas para todos os tipos possíveis.
InvoiceStatus
valores. Isso inclui:- Remessas com
InvoiceStatus=InvoiceCreatedByAmazon
. A Amazon emite uma fatura para essa transação, portanto, o vendedor não precisa fazer o upload de uma fatura. - Transações com
InvoiceStatus=NoTaxCalculated
. A Amazon não efetuou o cálculo do imposto para essa transação. Isso acontece, por exemplo, quando o item é enviado de um país para o qual o vendedor não forneceu um número de IVA válido na Central do Vendedor.
- Quando
Você pode determinar quando agende esses relatórios. Para cumprir o SLA de 24 horas, você pode criar um cronograma para cada 12 horas. Isso garante um atraso máximo de 12 horas após o envio de uma remessa.
Uma fatura é devida para cada remessa (não para cada pedido) após o envio da remessa. Uma remessa pode ter um dos seguintes status:
Status da fatura | Descrição | Action required |
---|---|---|
InvoicePending | A remessa foi despachada. | O vendedor deve fazer o upload de uma fatura da remessa. |
InvoiceProcessing | O vendedor fez o upload da fatura e a Amazon a está processando. | Nenhuma ação é exigida do vendedor neste momento. A Amazon processará a fatura. |
InvoiceUploaded | O vendedor fez o upload da fatura e a Amazon terminou de processá-la. Não foi detectado nenhum erro. | Nenhuma ação é exigida do vendedor. A fatura foi enviada com sucesso e está disponível para o cliente na página Seus pedidos. Os clientes podem baixar a fatura a qualquer momento. |
InvoiceRejected | O vendedor fez o upload da fatura e a Amazon terminou de processá-la. Foram detectados erros no upload. | O vendedor deve fazer o upload da fatura dessa remessa novamente. |
CreditNotePending | No caso de um reembolso, o dinheiro foi devolvido ao comprador. No caso de uma devolução, o item foi recebido no Centro de Distribuição da Amazon para pedidos Enviados pela Amazon ou foi autorizado pelo vendedor para pedidos enviados pelo vendedor. | A nota de crédito agora é devida para esta transação. |
CreditNoteProcessing | O vendedor fez o upload da fatura e a Amazon a está processando. | Nenhuma ação é exigida do vendedor neste momento. A Amazon processará a nota de crédito. |
CreditNoteUploaded | O vendedor fez o upload da nota de crédito e a Amazon terminou de processá-la. Não foi detectado nenhum erro. | Nenhuma ação é exigida do vendedor. Nota de crédito enviada com sucesso e disponibilizada para o cliente na página Seus pedidos. |
CreditNoteRejected | O vendedor fez o upload da nota de crédito e a Amazon terminou de processá-la. Foram detectados erros no upload. | O vendedor deve fazer o upload da nota de crédito para essa transação novamente. |
CreditNoteCreatedByAmazon | A Amazon criou uma nota de crédito para essa transação. | Nenhuma ação é exigida do vendedor. |
NoTaxCalculated | A Amazon não conseguiu calcular nenhum imposto para essa transação. Isso geralmente acontece quando o vendedor não enviou um número de IVA para o país de onde a remessa foi enviada. | A Amazon não calculará o IVA e o vendedor deverá fazer o upload da fatura dessa transação. O vendedor pode fazer o upload da fatura na Central do Vendedor ou com a SP-API. |
InvoiceCreatedByAmazon | A Amazon criou uma fatura para essa transação. | Nenhuma ação é exigida do vendedor. |
Colunas VIDR
A tabela a seguir explica cada coluna do VIDR:
Nome do campo | Definição | Exemplo |
---|---|---|
order-id | Identificador de pedido exclusivo da Amazon. Usado para confirmação de envio e processamento pós-pedido. | 736-3563777-5518068 |
order-item-id | Identificador exclusivo do item de pedido da Amazon. Usado para confirmação de envio e processamento pós-pedido. | 583563777345 |
shipping-id | ID de envio desta remessa. | 409302382 |
fulfilled-by | O canal de atendimento desse pedido. | MFN or FBA |
order-date | Data em que o pedido foi feito. | 17/05/2018 |
marketplace-id | O mercado no qual o pedido foi feito. | DE, FR, IT, ES |
recipient-name | Nome do destinatário. | Mary Major |
buyer-name | Nome do comprador. | Diego Ramirez |
ship-service-level | Nível de serviço de atendimento pago pelo comprador ao fazer o pedido do item. Por exemplo, padrão ou expresso. | Standard |
ship-address-1 | A primeira linha do endereço de envio. | 123 Any Street |
ship-address-2 | Segunda linha do endereço de envio. | Apt. 12 |
ship-address-3 | Terceira linha do endereço de envio. | c/o Example Corp. |
ship-city | Endereço da cidade de envio. | Any City |
ship-state | Endereço do estado do envio. | Any State |
ship-postal-code | Código postal do endereço de envio. | SL1 1QP |
ship-country | O código de país padrão internacional de duas letras (compatível com ISO 3166). | DE |
ship-phone-number | Número de telefone do endereço de entrega. | 999999999 |
shipment-date | Data de envio desta remessa. | 20/05/2018 |
billing-name | Nome de cobrança. | Márcia Oliveira |
bill-address-1 | A primeira linha do endereço de cobrança. | 100 Main Street |
bill-address-2 | A segunda linha do endereço de cobrança. | Apt. 12 |
bill-address-3 | A terceira linha do endereço de cobrança. | c/o AnyCompany |
bill-city | Cidade do endereço de cobrança. | Any City |
bill-state | Estado do endereço de cobrança. | Any State |
bill-postal-code | Código postal do endereço de cobrança. | U7D 294 |
bill-country | O código de país padrão internacional de duas letras (compatível com ISO 3166). | DE |
bill-phone-number | Número de telefone do endereço de cobrança. | 44234343 |
ship-from-city | Endereço do remetente da cidade de envio. | Any City |
ship-from-state | Endereço do remetente do estado do envio. | Any State |
ship-from-country | País de envio Endereço do remetente. | DE |
ship-from-postal-code | Código postal do endereço do remetente de envio. | 10178 |
sku | Unidade de manutenção de estoque. Identificador exclusivo definido pelo vendedor para um produto. | sku123 |
product-name | Nome do produto. | DJI CP.PT.03342 Spark - Battery Charging Hub |
quantity-purchased | Quantidade comprada. | 1 |
currency | A moeda usada para a transação. | EUR |
asin | ASIN do produto. | AY39345YE8K |
item-vat-incl-amount | Preço do item com IVA incluído. | 120.00 |
item-vat-amount | Valor do IVA do preço do item. | 20.00 |
item-vat-excl-amount | Preço do item sem IVA. | 100.00 |
item-vat-rate | Taxa de IVA do preço do item. | 0.20 |
gift-wrap-vat-incl-amount | Embalagem de presente com IVA total incluído. | 12.00 |
gift-wrap-vat-amount | Valor total do IVA da embalagem para presente. | 2.00 |
gift-wrap-vat-excl-amount | Embalagem de presente com IVA total. | 10.00 |
gift-wrap-vat-rate | Taxa total de IVA do preço do presente. | 0.20 |
shipping-vat-incl-amount | Preço de envio com IVA incluído. | 6.00 |
shipping-vat-amount | Valor do IVA do preço do frete. | 1.00 |
shipping-vat-excl-amount | Preço de envio sem IVA. | 5.00 |
shipping-vat-rate | Taxa de IVA do preço do frete. | 0.20 |
item-promo-vat-incl-amount | Promoção total de itens com IVA incluído. | -0.12 |
item-promo-vat-amount | Promoção do item com o valor total do IVA. | -0.02 |
item-promo-vat-excl-amount | Promoção total de itens sem IVA. | -0.10 |
item-promo-vat-rate | Promoção total do item com taxa de IVA. | 0.20 |
item-promotion-id | ID da promoção do item promocional. Um valor alfanumérico gerado pela Amazon. | 136643052:AKY54VWVKS3JCY6T |
shipping-promo-vat-incl-amount | Promoção de frete com IVA total incluído. | -0.12 |
shipping-promo-vat-amount | Promoção de envio com o valor total do IVA. | -0.02 |
shipping-promo-vat-excl-amount | Promoção de frete sem IVA total. | -0.10 |
shipping-promo-vat-rate | Promoção de frete com taxa total de IVA. | 0.20 |
shipping-promotion-id | ID da promoção de envio. Um valor alfanumérico gerado pela Amazon. | 3943834723:BWJRJERIUDKERU |
gift-promo-vat-incl-amount | Promoção de papel para presente com IVA total incluído. | -0.20 |
gift-promo-vat-amount | Promoção de papel para presente com o valor total do IVA. | -0.12 |
gift-promo-vat-excl-amount | Promoção de papel para presente com IVA total. | -0.02 |
gift-promo-vat-rate | Promoção de papel para presente com taxa total de IVA. | 0.10 |
gift-promotion-id | ID promocional da promoção de papel para presente. | 385934052:BWJRJDJSDS3JCY6T |
transaction-id | Para remessas, esse é o ID de envio. Para devoluções, esse é um ID de transação exclusivo que difere do ID de envio. | 409302382 (para uma remessa); amzn1:crow:a0f6kwafsv6ymalmhe4vjw (para devolução ou reembolso) |
transaction-type | O tipo de transação. | ENVIO, DEVOLUÇÃO OU REEMBOLSO |
is-amazon-invoiced | Indica se a Amazon cria uma fatura para essa transação. É true se o vendedor usar o VCS e escolher a opção de permitir que a Amazon crie as faturas ou se a Amazon World Imports comprar do vendedor. O vendedor não deve criar faturas para essas transações. A Amazon gerará uma fatura e a disponibilizará para o vendedor. | TRUE ou FALSE |
invoice-status | Status da fatura. | Consulte Etapa 1 para obter detalhes sobre o status da fatura. |
invoice-status-description | Descrição do status da fatura. | Consulte Etapa 1 para obter detalhes sobre o status da fatura. |
is-business-order | Esse pedido foi feito no site da Amazon Business ou no site B2C? | TRUE ou FALSE |
purchase-order-number | Número do pedido de compra (se fornecido pelo cliente). | AB45-234934 (can be any string) |
seller-vat-number | Número de IVA do vendedor usado no cálculo do IVA. | DE111111111 |
buyer-vat-number | Número de IVA do comprador usado no cálculo do IVA. | DE22222222 ou em branco se o cliente não tiver um número de IVA na Amazon. |
buyer-company-name | Nome da empresa do comprador. | Qualquer empresa |
price-designation | Indica se esse é o preço comercial ou o preço padrão. | Business Price or Standard Price |
invoice-number | O número da fatura fornecido pelo vendedor. No caso de uma visualização PendingInvoices , a coluna fica em branco porque a fatura não foi carregada. No caso de uma visualização All , a coluna conterá o número da fatura enviada pelo vendedor. | XXXX |
legacy-customer-order-item-id | Esse ID do item do pedido é o mesmo encontrado nos relatórios do Logística da Amazon (FBA) e nos relatórios da Rede de logística do vendedor (MFN). Se você quiser combinar os itens de linha individuais de um VIDR com relatórios FBA ou MFN, você pode usar essa coluna. | 82840304120340 |
buyer-tax-registration-type | O tipo de imposto do cliente (se o cliente tiver um número de registro fiscal). | IVA, BusinessReg, CitizenID. Nos mercados da Espanha e da Itália, as empresas podem ter um número de registro comercial (BusinessReg) e os indivíduos podem ter IDs fiscais (CitizenID). |
is-buyer-physically-present | Verdadeiro se o cliente estiver fisicamente estabelecido no país para o qual o número fiscal foi fornecido no buyer-vat-number coluna. | TRUE ou FALSE |
is-seller-physically-present | Verdadeiro se o vendedor estiver fisicamente estabelecido no país para o qual o número de IVA foi fornecido no seller-vat-number coluna. | TRUE ou FALSE |
buyer-e-invoice-account-id | O ID da conta da fatura eletrônica do cliente. Isso é preenchido se o cliente tiver fornecido um ID de conta de fatura eletrônica (que pode ser usado para enviar a fatura ao Sistema di Interscambio [SDi], se necessário). Essa coluna foi adicionada especificamente para a lei de faturamento eletrônico da Itália que entrou em vigor em 2019 para os vendedores poderem enviar faturas para a SDi. | XXXXXXXX |
recommended-invoice-format | Formato de fatura recomendado para ser enviado às autoridades fiscais. Se o valor for PDF, você deverá fazer o upload do formato da fatura em PDF para a Amazon e usar o mesmo PDF da cópia verdadeira da fatura. Se o formato recomendado for XML, a Amazon determinou que o cliente é um cliente B2B em TI e que o vendedor está fisicamente estabelecido em TI, portanto, o vendedor deve fazer o upload de uma fatura XML no Sistema di Interscambio (SdI) de acordo com a lei italiana de faturas eletrônicas. A fatura XML que está disponível no SdI é considerada a cópia verdadeira da fatura. No entanto, você também deve fazer o upload de uma fatura em PDF para a Amazon. O PDF deve conter texto adicional ou uma marca d'água para indicar que é uma fatura duplicada. O cliente pode recuperar a fatura original da SdI. Observe que, independentemente do valor nesta coluna, o vendedor deve sempre fazer o upload de uma fatura em PDF para a Amazon usando o tipo de feed de upload de fatura. | PDF ou XML. |
Citation-en | Esta coluna fornece o texto da citação em inglês. | Recomendamos que o vendedor use o texto da citação fornecido na fatura. O vendedor tem a liberdade de escolher o idioma que deseja usar para a citação, dependendo do idioma na fatura. |
Citation-de | Esta coluna fornece o texto da citação em alemão. | Recomendamos que o vendedor use o texto da citação fornecido na fatura. O vendedor tem a liberdade de escolher o idioma que deseja usar para a citação, dependendo do idioma na fatura. |
Citation-es | Esta coluna fornece o texto da citação em espanhol. | Recomendamos que o vendedor use o texto da citação fornecido na fatura. O vendedor tem a liberdade de escolher o idioma que deseja usar para a citação, dependendo do idioma na fatura. |
Citation-fr | Esta coluna fornece o texto da citação em francês. | Recomendamos que o vendedor use o texto da citação fornecido na fatura. O vendedor tem a liberdade de escolher o idioma que deseja usar para a citação, dependendo do idioma na fatura. |
Citation-it | Esta coluna fornece o texto da citação em italiano. | Recomendamos que o vendedor use o texto da citação fornecido na fatura. O vendedor tem a liberdade de escolher o idioma que deseja usar para a citação, dependendo do idioma na fatura. |
Is-invoice-corrected | Indica se essa transação se refere a uma fatura corrigida anteriormente. True se essa transação for uma correção de uma transação anterior. | TRUE ou FALSE |
original-vat-invoice-number | O número da fatura da remessa original que exige uma correção na fatura. | O número original da fatura. |
invoice-correction-details | Detalhes da alteração da fatura descrevendo as alterações na fatura. Isso só se aplica à transação de alteração de fatura. | Uma nova fatura é emitida após a alteração do endereço de cobrança na fatura de IVA original; ou uma nota de crédito é emitida para alterar o endereço de cobrança na fatura de IVA original. |
Etapa 2. Crie suas próprias faturas a partir dos dados do relatório VIDR
Baixe o relatório VIDR e use as informações para compilar sua fatura de IVA.
Etapa 3. Faça upload de faturas para a Amazon usando a API Feeds
Chame a operação createFeed
para validar UPLOAD_VAT_INVOICE
e feedType
.
Dica
Para obter os IDs de mercado do seu país, consulte IDs de mercado.
Para feedOptions
, você deve especificar metadados nos pares chave:valor com a fatura em PDF. Ou OrderId
ou ShippingId
é necessário quando você carrega uma fatura (ShippingId
é o preferido).
OrderId
: O identificador do pedido para o qual a fatura está sendo enviada.ShippingId
: O identificador da remessa para a qual a fatura está sendo enviada.
Se você incluir OrderId
e ShippingId
, a Amazon ignora o ID do pedido e carrega a fatura com o ID de envio. Se nenhum deles for fornecido, você poderá receber um erro. Para obter ajuda com erros, consulte Tratamento de erros.
O seguinte feedOptions
está requeridos:
TotalAmount
. O valor total na fatura. Este é o preço com IVA incluído para itens, embalagens para presentes e frete, menos o IVA para todas as promoções. Se o valor total especificado não corresponder ao valor total da Amazon para essa remessa (com duas casas decimais), o upload da fatura será rejeitado. Recomendamos seguir rigorosamente os cálculos fiscais fornecidos no VIDR.TotalVATAmount
. O valor total do IVA na fatura. Esse é o IVA dos itens, do embrulho e do frete, menos o IVA de todas as promoções. Se o valor do IVA não corresponder ao valor do IVA calculado pela Amazon para essa remessa (com duas casas decimais), o upload da fatura será rejeitado. Recomendamos seguir rigorosamente os cálculos fiscais fornecidos no VIDR.InvoiceNumber
. O número da fatura que é usado na fatura. Esse número da fatura é compartilhado com os clientes. Os vendedores devem garantir que o mesmo número da fatura apareça na fatura.
O seguinte feedOptions
está opcionais:
-
DocumentType
. Valores possíveis:Invoice
. Use isso se você estiver fazendo o upload de uma fatura.CreditNote
. Use isso se você estiver enviando uma nota de crédito para reembolso ou devolução.
O valor padrão éInvoice
.
-
TransactionId
, definido comoDocumentType=CreditNote
.
Atenção
Não adicione aspas em torno de chaves ou valores. A Amazon só aceita os seguintes caracteres: vírgulas (
,
), barras dianteiras (/
), barras invertidas (\
), espaços (), traços (-
), sublinhados (_
), ponto e vírgula (;
), cólon (:
), hashes (#
), 0-9, A-Z, a-z. A Amazon reduz o espaço extra.
O limite de limitação para o feed de faturamento (UPLOAD_VAT_INVOICE
) é um upload de fatura a cada três segundos.
Exemplos
Uploads de faturas:
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}
Notas de crédito (CN-123-ABC
é o número da nota de crédito):
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}
Código Java para criar as opções de feed:
Map<String, String> feedOptions = new HashMap<>(); // building parameter map
feedOptions.put("metadata:OrderId", "XXX-XXXXXXX-XXXXXXX");
feedOptions.put("metadata:TotalAmount", String.format(TOTALAMMOUNT));
feedOptions.put("metadata:TotalVATAmount", String.format(TOTALVATAMMOUNT));
feedOptions.put("metadata:InvoiceNumber", INVOICE_NUMBER);
String options = feedOptions.entrySet().stream()
.map(e -> String.format("%s=%s", e.getKey(), e.getValue()))
.collect(Collectors.joining(";"));
File pdfD = new File("<PATH TO PDF>");
byte[] pdfDocument = FileUtils.readFileToByteArray(pdfD); // read pdf document to byte array
String contentMD5 = Base64.encodeBase64String(pdfDocument); // building hash code
InputStream contentStream = new ByteArrayInputStream(pdfDocument); // inputstream of
SubmitFeedResponse response = submitFeed(contentStream, contentMD5, "_UPLOAD_VAT_INVOICE_", options, ContentType.OctetStream);
public SubmitFeedResponse submitFeed(InputStream, String contentMD5, String feedType, String feedOptions, ContentType contentType)
{
SubmitFeedRequest request = new SubmitFeedRequest();
request.setContentMD5(contentMD5);
request.setFeedContent(inputStream);
request.setFeedOptions(feedOptions);
request.setFeedType(feedType);
request.setMarketplaceIdList(new IdList(Arrays.asList(getMarketPlaces());
request.setMerchant(configuration.getAmazon().getSellerId());
request.setMWSAuthToken(configuration.getAmazon().getMwsAuthToken());
request.setContentType(contentType);
return getMarketplaceWebServiceClient().submitFeed(request);
}
Carregar faturas manualmente
Todos os vendedores que escolherem não para se inscrever no VCS, tenha a opção padrão de enviar suas próprias faturas para a Amazon usando a API ou a Central do Vendedor. Esta seção descreve o uso da API.
Para carregar faturas manualmente, você deve usar seus próprios dados fiscais para criar suas faturas. Você vai não tenha acesso a um relatório VIDR.
Chame a operação createFeed
para validar UPLOAD_VAT_INVOICE
e feedType
.
Dica
Para obter os IDs de mercado do seu país, consulte IDs de mercado.
Para feedOptions
, você deve especificar metadados nos pares chave:valor com a fatura em PDF. Ou OrderId
ou ShippingId
é necessário quando você carrega uma fatura (ShippingId
é o preferido).
OrderId
: O identificador do pedido para o qual a fatura está sendo enviada.ShippingId
: O identificador da remessa para a qual a fatura está sendo enviada.
Se você incluir OrderId
e ShippingId
, a Amazon ignora o ID do pedido e carrega a fatura com o ID de envio. Se nenhum deles for fornecido, você poderá receber um erro. Para obter ajuda com erros, consulte Tratamento de erros.
O seguinte feedOptions
está requeridos:
InvoiceNumber
. O número da fatura que é usado na fatura. Esse número da fatura é compartilhado com os clientes. Os vendedores devem garantir que o mesmo número da fatura apareça na fatura.DocumentType
. Valores possíveis:Invoice
. Use isso se você estiver fazendo o upload de uma fatura.CreditNote
. Use isso se você estiver enviando uma nota de crédito para reembolso ou devolução.
O valor padrão éInvoice
.
Dica
Com os carregamentos manuais, você pode fazer o upload de mais de uma fatura com o mesmo ID de pedido. No entanto, o número da fatura deve ser exclusivo. Somente a fatura mais recente é considerada válida.
O seguinte feedOptions
está opcionais:
TotalAmount
. O valor total na fatura. Este é o preço com IVA incluído para itens, embalagens para presentes e frete, menos o IVA para todas as promoções. Se o valor total especificado não corresponder ao valor total da Amazon para essa remessa (com duas casas decimais), o upload da fatura será rejeitado. Recomendamos seguir rigorosamente os cálculos fiscais fornecidos no VIDR.TotalVATAmount
. O valor total do IVA na fatura. Esse é o IVA dos itens, do embrulho e do frete, menos o IVA de todas as promoções. Se o valor do IVA não corresponder ao valor do IVA calculado pela Amazon para essa remessa (com duas casas decimais), o upload da fatura será rejeitado. Recomendamos seguir rigorosamente os cálculos fiscais fornecidos no VIDR.TransactionId
, definido comoDocumentType=CreditNote
.
Atenção
Não adicione aspas em torno de chaves ou valores. A Amazon só aceita os seguintes caracteres: vírgulas (
,
), barras dianteiras (/
), barras invertidas (\
), espaços (), traços (-
), sublinhados (_
), ponto e vírgula (;
), cólon (:
), hashes (#
), 0-9, A-Z, a-z. A Amazon reduz o espaço extra.
O limite de limitação para o feed de faturamento (UPLOAD_VAT_INVOICE
) é um upload de fatura a cada três segundos.
Exemplos
Uploads de faturas:
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}
Notas de crédito (CN-123-ABC
é o número da nota de crédito):
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}
Você pode usar o código de exemplo a seguir para anexar o arquivo PDF. Embora esse exemplo esteja em Java, você pode usá-lo como modelo para outras linguagens de programação.
Map<String, String> feedOptions = new HashMap<>(); // building parameter map
feedOptions.put("metadata:OrderId", "XXX-XXXXXXX-XXXXXXX");
feedOptions.put("metadata:TotalAmount", String.format(TOTALAMMOUNT));
feedOptions.put("metadata:TotalVATAmount", String.format(TOTALVATAMMOUNT));
feedOptions.put("metadata:InvoiceNumber", INVOICE_NUMBER);
String options = feedOptions.entrySet().stream()
.map(e -\> String.format("%s=%s", e.getKey(), e.getValue()))
.collect(Collectors.joining(";"));
File pdfD = new File("\<PATH TO PDF\>");
byte\[\] pdfDocument = FileUtils.readFileToByteArray(pdfD); // read pdf document to byte array
String contentMD5 = Base64.encodeBase64String(pdfDocument); // building hash code
InputStream contentStream = new ByteArrayInputStream(pdfDocument); // inputstream of
SubmitFeedResponse response = submitFeed(contentStream, contentMD5, "\_UPLOAD_VAT_INVOICE\_", options, ContentType.OctetStream);
public SubmitFeedResponse submitFeed(InputStream, String contentMD5, String feedType, String feedOptions, ContentType contentType)
{
SubmitFeedRequest request = new SubmitFeedRequest();
request.setContentMD5(contentMD5);
request.setFeedContent(inputStream);
request.setFeedOptions(feedOptions);
request.setFeedType(feedType);
request.setMarketplaceIdList(new IdList(Arrays.asList(getMarketPlaces());
request.setMerchant(configuration.getAmazon().getSellerId());
request.setMWSAuthToken(configuration.getAmazon().getMwsAuthToken());
request.setContentType(contentType);
return getMarketplaceWebServiceClient().submitFeed(request);
}
Updated 28 days ago