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:

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).

APIAPI de relatórios
OperationcreateReport
ReportTypeSC_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) e item_tax (em relatórios de arquivo simples). Contém o valor do IVA, calculado pela Amazon.
  • ItemPrice (em relatórios XML) e item_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:

  1. Vá para Adicionar ou remover colunas do relatório de pedidos no Seller Central.

  2. 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) e item_tax (em relatórios de arquivo simples). Contém o valor do IVA, calculado pela Amazon.
  • ItemPrice (em relatórios XML) e item_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ão ReportOption 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 de all.

    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 ou CreditNotePending). 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.

  • 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 o startDate e endDate parâmetros para o createReport operação. O dataStartTime e dataEndTime os valores devem corresponder aos primeiros e últimos dias válidos no especificado reportPeriod. Por exemplo, quando reportPeriod=WEEK, dataStartTime deve ser um domingo e dataEndTime deve ser um sábado. O intervalo de datas máximo permitido é de 30 dias.
    • Quando false, ou se all não está incluído em reportOptions, o conteúdo do relatório depende do valor de pendingInvoices. 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.

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 faturaDescriçãoAction required
InvoicePendingA remessa foi despachada.O vendedor deve fazer o upload de uma fatura da remessa.
InvoiceProcessingO 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.
InvoiceUploadedO 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.
InvoiceRejectedO 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.
CreditNotePendingNo 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.
CreditNoteProcessingO 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.
CreditNoteUploadedO 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.
CreditNoteRejectedO 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.
CreditNoteCreatedByAmazonA Amazon criou uma nota de crédito para essa transação.Nenhuma ação é exigida do vendedor.
NoTaxCalculatedA 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.
InvoiceCreatedByAmazonA Amazon criou uma fatura para essa transação.Nenhuma ação é exigida do vendedor.

Colunas VIDR

Exemplo de relatório VIDRReport link
XMLCSV

A tabela a seguir explica cada coluna do VIDR:

Nome do campoDefiniçãoExemplo
order-idIdentificador de pedido exclusivo da Amazon. Usado para confirmação de envio e processamento pós-pedido.736-3563777-5518068
order-item-idIdentificador exclusivo do item de pedido da Amazon. Usado para confirmação de envio e processamento pós-pedido.583563777345
shipping-idID de envio desta remessa.409302382
fulfilled-byO canal de atendimento desse pedido.MFN or FBA
order-dateData em que o pedido foi feito.17/05/2018
marketplace-idO mercado no qual o pedido foi feito.DE, FR, IT, ES
recipient-nameNome do destinatário.Mary Major
buyer-nameNome do comprador.Diego Ramirez
ship-service-levelNível de serviço de atendimento pago pelo comprador ao fazer o pedido do item. Por exemplo, padrão ou expresso.Standard
ship-address-1A primeira linha do endereço de envio.123 Any Street
ship-address-2Segunda linha do endereço de envio.Apt. 12
ship-address-3Terceira linha do endereço de envio.c/o Example Corp.
ship-cityEndereço da cidade de envio.Any City
ship-stateEndereço do estado do envio.Any State
ship-postal-codeCódigo postal do endereço de envio.SL1 1QP
ship-countryO código de país padrão internacional de duas letras (compatível com ISO 3166).DE
ship-phone-numberNúmero de telefone do endereço de entrega.999999999
shipment-dateData de envio desta remessa.20/05/2018
billing-nameNome de cobrança.Márcia Oliveira
bill-address-1A primeira linha do endereço de cobrança.100 Main Street
bill-address-2A segunda linha do endereço de cobrança.Apt. 12
bill-address-3A terceira linha do endereço de cobrança.c/o AnyCompany
bill-cityCidade do endereço de cobrança.Any City
bill-stateEstado do endereço de cobrança.Any State
bill-postal-codeCódigo postal do endereço de cobrança.U7D 294
bill-countryO código de país padrão internacional de duas letras (compatível com ISO 3166).DE
bill-phone-numberNúmero de telefone do endereço de cobrança.44234343
ship-from-cityEndereço do remetente da cidade de envio.Any City
ship-from-stateEndereço do remetente do estado do envio.Any State
ship-from-countryPaís de envio Endereço do remetente.DE
ship-from-postal-codeCódigo postal do endereço do remetente de envio.10178
skuUnidade de manutenção de estoque. Identificador exclusivo definido pelo vendedor para um produto.sku123
product-nameNome do produto.DJI CP.PT.03342 Spark - Battery Charging Hub
quantity-purchasedQuantidade comprada.1
currencyA moeda usada para a transação.EUR
asinASIN do produto.AY39345YE8K
item-vat-incl-amountPreço do item com IVA incluído.120.00
item-vat-amountValor do IVA do preço do item.20.00
item-vat-excl-amountPreço do item sem IVA.100.00
item-vat-rateTaxa de IVA do preço do item.0.20
gift-wrap-vat-incl-amountEmbalagem de presente com IVA total incluído.12.00
gift-wrap-vat-amountValor total do IVA da embalagem para presente.2.00
gift-wrap-vat-excl-amountEmbalagem de presente com IVA total.10.00
gift-wrap-vat-rateTaxa total de IVA do preço do presente.0.20
shipping-vat-incl-amountPreço de envio com IVA incluído.6.00
shipping-vat-amountValor do IVA do preço do frete.1.00
shipping-vat-excl-amountPreço de envio sem IVA.5.00
shipping-vat-rateTaxa de IVA do preço do frete.0.20
item-promo-vat-incl-amountPromoção total de itens com IVA incluído.-0.12
item-promo-vat-amountPromoção do item com o valor total do IVA.-0.02
item-promo-vat-excl-amountPromoção total de itens sem IVA.-0.10
item-promo-vat-ratePromoção total do item com taxa de IVA.0.20
item-promotion-idID da promoção do item promocional. Um valor alfanumérico gerado pela Amazon.136643052:AKY54VWVKS3JCY6T
shipping-promo-vat-incl-amountPromoção de frete com IVA total incluído.-0.12
shipping-promo-vat-amountPromoção de envio com o valor total do IVA.-0.02
shipping-promo-vat-excl-amountPromoção de frete sem IVA total.-0.10
shipping-promo-vat-ratePromoção de frete com taxa total de IVA.0.20
shipping-promotion-idID da promoção de envio. Um valor alfanumérico gerado pela Amazon.3943834723:BWJRJERIUDKERU
gift-promo-vat-incl-amountPromoção de papel para presente com IVA total incluído.-0.20
gift-promo-vat-amountPromoção de papel para presente com o valor total do IVA.-0.12
gift-promo-vat-excl-amountPromoção de papel para presente com IVA total.-0.02
gift-promo-vat-ratePromoção de papel para presente com taxa total de IVA.0.10
gift-promotion-idID promocional da promoção de papel para presente.385934052:BWJRJDJSDS3JCY6T
transaction-idPara 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-typeO tipo de transação.ENVIO, DEVOLUÇÃO OU REEMBOLSO
is-amazon-invoicedIndica 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-statusStatus da fatura.Consulte Etapa 1 para obter detalhes sobre o status da fatura.
invoice-status-descriptionDescrição do status da fatura.Consulte Etapa 1 para obter detalhes sobre o status da fatura.
is-business-orderEsse pedido foi feito no site da Amazon Business ou no site B2C?TRUE ou FALSE
purchase-order-numberNúmero do pedido de compra (se fornecido pelo cliente).AB45-234934 (can be any string)
seller-vat-numberNúmero de IVA do vendedor usado no cálculo do IVA.DE111111111
buyer-vat-numberNú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-nameNome da empresa do comprador.Qualquer empresa
price-designationIndica se esse é o preço comercial ou o preço padrão.Business Price or Standard Price
invoice-numberO 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-idEsse 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-typeO 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-presentVerdadeiro 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-presentVerdadeiro 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-idO 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-formatFormato 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-enEsta 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-deEsta 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-esEsta 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-frEsta 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-itEsta 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-correctedIndica 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-numberO número da fatura da remessa original que exige uma correção na fatura.O número original da fatura.
invoice-correction-detailsDetalhes 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 como DocumentType=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 como DocumentType=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); }

Esta página ajudou você?