{"id":6008,"date":"2026-09-02T16:49:27","date_gmt":"2026-09-02T19:49:27","guid":{"rendered":"https:\/\/helpcenter.uappi.com.br\/?p=6008"},"modified":"2026-09-03T10:02:55","modified_gmt":"2026-09-03T13:02:55","slug":"como-configurar-o-calculo-de-impostos-sobre-produtos","status":"publish","type":"post","link":"https:\/\/helpcenter.uappi.com.br\/en\/como-configurar-o-calculo-de-impostos-sobre-produtos\/","title":{"rendered":"Como configurar o c\u00e1lculo de impostos sobre produtos"},"content":{"rendered":"

O recurso Impostos sobre produto<\/strong> permite integrar o checkout da Uappi a um servi\u00e7o externo respons\u00e1vel pelo c\u00e1lculo de impostos dos itens do carrinho.<\/p>\n\n\n\n

Nesse fluxo, a Uappi envia os dados dispon\u00edveis do carrinho para o servi\u00e7o configurado pela loja. O servi\u00e7o externo realiza o c\u00e1lculo e devolve o pre\u00e7o unit\u00e1rio calculado e as taxas correspondentes, que s\u00e3o aplicados no checkout.<\/p>\n\n\n\n

O c\u00e1lculo fiscal \u00e9 realizado pelo servi\u00e7o externo<\/strong>. A Uappi \u00e9 respons\u00e1vel por enviar as informa\u00e7\u00f5es dispon\u00edveis, receber o resultado e aplicar os valores retornados.<\/p>\n\n\n\n

Importante:<\/strong> o recurso \u00e9 exclusivo para lojas que utilizam o modelo de neg\u00f3cio B2B<\/strong>. Ele n\u00e3o \u00e9 executado em lojas B2C ou B2B2C. <\/p>\n\n\n\n

O fluxo funciona da seguinte forma:<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Para isso, o ERP, integrador ou motor de c\u00e1lculo deve disponibilizar um endpoint compat\u00edvel com o contrato esperado pela Uappi.<\/p>\n\n\n\n

A comunica\u00e7\u00e3o utiliza:<\/p>\n\n\n\n

    \n
  • m\u00e9todo POST;<\/li>\n\n\n\n
  • Content-Type: application\/json;<\/li>\n\n\n\n
  • resposta HTTP 200;<\/li>\n\n\n\n
  • retorno em JSON em at\u00e9 60 segundos.<\/li>\n<\/ul>\n\n\n\n

    No fluxo do App Impostos sobre produto<\/strong>, a Uappi n\u00e3o envia autentica\u00e7\u00e3o adicional no header da requisi\u00e7\u00e3o. Caso o servi\u00e7o exija uma chave de acesso, a autentica\u00e7\u00e3o deve ser tratada pelo pr\u00f3prio servi\u00e7o, por exemplo, por meio da URL ou de outra estrat\u00e9gia definida pelo integrador.<\/p>\n\n\n\n

    \n\n\n\n

    Antes de come\u00e7ar<\/strong><\/h2>\n\n\n\n

    Para utilizar o c\u00e1lculo de impostos sobre produtos, \u00e9 necess\u00e1rio:<\/p>\n\n\n\n

      \n
    • utilizar uma loja no modelo B2B<\/strong>;<\/li>\n\n\n\n
    • manter o App Impostos sobre produto<\/strong> ativo;<\/li>\n\n\n\n
    • possuir um servi\u00e7o externo preparado para receber e processar a requisi\u00e7\u00e3o;<\/li>\n\n\n\n
    • configurar a URL de consulta<\/strong> desse servi\u00e7o na Uappi.<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n

      Como configurar na Uappi<\/strong><\/h2>\n\n\n\n

      No painel administrativo:<\/p>\n\n\n\n

        \n
      1. Acesse Apps<\/strong>.<\/li>\n\n\n\n
      2. Localize o App Impostos sobre produto<\/strong>.<\/li>\n\n\n\n
      3. No campo URL de consulta<\/strong>, informe o endpoint disponibilizado pelo ERP, integrador ou motor de c\u00e1lculo.<\/li>\n\n\n\n
      4. Ative o Status<\/strong>.<\/li>\n\n\n\n
      5. Salve as altera\u00e7\u00f5es.<\/li>\n<\/ol>\n\n\n\n

        A URL informada ser\u00e1 utilizada pela Uappi para enviar as requisi\u00e7\u00f5es de c\u00e1lculo de impostos.<\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n
        \"\"<\/figure>\n\n\n\n
        \n\n\n\n

        Estrutura enviada pela Uappi<\/strong><\/h2>\n\n\n\n

        Ao realizar a consulta, a Uappi envia um JSON contendo informa\u00e7\u00f5es dos itens, cliente, entrega e frete<\/strong>.<\/p>\n\n\n\n

        A estrutura da requisi\u00e7\u00e3o \u00e9 organizada conforme apresentado abaixo:<\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n

        Importante:<\/strong> a modalidadePedido enviada atualmente pela integra\u00e7\u00e3o \u00e9 consumo.<\/p>\n\n\n\n

        Dados dos itens<\/strong><\/h2>\n\n\n\n

        Cada objeto de itens pode conter:<\/p>\n\n\n\n

                      Campo<\/strong><\/td>                                        Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
        indice<\/td>Identificador do item no carrinho. Deve ser devolvido pelo integrador exatamente como recebido<\/td><\/tr>
        id<\/td>ID do produto na Uappi<\/td><\/tr>
        sku<\/td>SKU do produto<\/td><\/tr>
        tipo<\/td>Tipo do item: produto ou servico<\/td><\/tr>
        quantidade<\/td>Quantidade considerada no c\u00e1lculo<\/td><\/tr>
        valor<\/td>Pre\u00e7o unit\u00e1rio antes da aplica\u00e7\u00e3o do imposto<\/td><\/tr>
        valorFrete<\/td>Valor do frete correspondente ao item. Pode ser null quando n\u00e3o houver um valor num\u00e9rico dispon\u00edvel. <\/td><\/tr>
        ean<\/td>Campo destinado ao EAN do item. Atualmente, pode ser enviado vazio (“”). <\/td><\/tr>
        idMarca<\/td>Identificador da marca<\/td><\/tr>
        idCategoria<\/td>Identificador da categoria<\/td><\/tr>
        armazem.cep<\/td>CEP do armaz\u00e9m de origem<\/td><\/tr>
        armazem.codigo<\/td>C\u00f3digo do armaz\u00e9m<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        O campo indice \u00e9 utilizado pela Uappi para relacionar o item enviado ao resultado retornado pelo servi\u00e7o. Por isso, o mesmo valor recebido deve ser devolvido na resposta<\/strong>.<\/p>\n\n\n\n

        Dados do cliente<\/strong><\/h2>\n\n\n\n

        Quando dispon\u00edveis, s\u00e3o enviados dados cadastrais e tribut\u00e1rios do cliente, como:<\/p>\n\n\n\n

          \n
        • nome ou raz\u00e3o social;<\/li>\n\n\n\n
        • e-mail;<\/li>\n\n\n\n
        • CPF ou CNPJ;<\/li>\n\n\n\n
        • RG ou Inscri\u00e7\u00e3o Estadual;<\/li>\n\n\n\n
        • telefone;<\/li>\n\n\n\n
        • celular;<\/li>\n\n\n\n
        • status tribut\u00e1rio;<\/li>\n\n\n\n
        • natureza jur\u00eddica.<\/li>\n<\/ul>\n\n\n\n

          O campo statusTributario pode utilizar:<\/p>\n\n\n\n

            \n
          • nao-contribuinte;<\/li>\n\n\n\n
          • contribuinte;<\/li>\n\n\n\n
          • isento.<\/li>\n<\/ul>\n\n\n\n

            O campo naturezaJuridica utiliza:<\/p>\n\n\n\n

              \n
            • pessoa-fisica;<\/li>\n\n\n\n
            • pessoa-juridica.<\/li>\n<\/ul>\n\n\n\n

              Dados de entrega e origem<\/strong><\/h2>\n\n\n\n

              A Uappi tamb\u00e9m envia informa\u00e7\u00f5es relacionadas ao destino da entrega e \u00e0 origem do produto.<\/p>\n\n\n\n

              Entre elas est\u00e3o:<\/p>\n\n\n\n

                \n
              • CEP de destino;<\/li>\n\n\n\n
              • endere\u00e7o;<\/li>\n\n\n\n
              • bairro;<\/li>\n\n\n\n
              • cidade;<\/li>\n\n\n\n
              • UF;<\/li>\n\n\n\n
              • n\u00famero;<\/li>\n\n\n\n
              • complemento;<\/li>\n\n\n\n
              • refer\u00eancia;<\/li>\n\n\n\n
              • CEP do armaz\u00e9m;<\/li>\n\n\n\n
              • c\u00f3digo do armaz\u00e9m;<\/li>\n\n\n\n
              • valor de frete.<\/li>\n<\/ul>\n\n\n\n

                O CEP de entrega \u00e9 necess\u00e1rio para a consulta do App.<\/p>\n\n\n\n

                Aten\u00e7\u00e3o:<\/strong> sem um CEP de entrega informado, a Uappi n\u00e3o realiza a chamada ao servi\u00e7o de c\u00e1lculo. Em opera\u00e7\u00f5es com multiestoque, o item tamb\u00e9m precisa possuir frete calculado para ser enviado na consulta. Por isso, durante a homologa\u00e7\u00e3o, realize os testes com CEP informado e frete calculado<\/strong>. <\/p>\n\n\n\n

                \n\n\n\n

                Informa\u00e7\u00f5es fiscais utilizadas pelo integrador<\/strong><\/h2>\n\n\n\n

                O cadastro e as regras fiscais necess\u00e1rias para realizar o c\u00e1lculo devem estar dispon\u00edveis no pr\u00f3prio ERP, integrador ou motor externo.<\/p>\n\n\n\n

                Nesta integra\u00e7\u00e3o, a Uappi n\u00e3o envia<\/strong> informa\u00e7\u00f5es como:<\/p>\n\n\n\n

                  \n
                • NCM;<\/li>\n\n\n\n
                • CFOP;<\/li>\n\n\n\n
                • CST;<\/li>\n\n\n\n
                • c\u00f3digo de origem fiscal da mercadoria;<\/li>\n\n\n\n
                • CEST;<\/li>\n\n\n\n
                • cupom;<\/li>\n\n\n\n
                • canal;<\/li>\n\n\n\n
                • meio de pagamento.<\/li>\n<\/ul>\n\n\n\n

                  Para localizar o cadastro fiscal correspondente ao produto, o servi\u00e7o externo pode utilizar informa\u00e7\u00f5es enviadas pela Uappi, como sku ou id.<\/p>\n\n\n\n

                  Importante:<\/strong> o servi\u00e7o externo \u00e9 respons\u00e1vel pela regra e pelo c\u00e1lculo fiscal. A Uappi utiliza o resultado devolvido para atualizar o checkout.<\/p>\n\n\n\n

                  \n\n\n\n

                  Estrutura que o integrador deve retornar<\/strong><\/h2>\n\n\n\n

                  Para cada item recebido, o servi\u00e7o externo deve retornar um objeto correspondente dentro de taxasItens.<\/p>\n\n\n\n

                  \"\"<\/figure>\n\n\n\n

                  Importante:<\/strong> os nomes das taxas apresentados s\u00e3o apenas ilustrativos. O campo nome \u00e9 livre e n\u00e3o possui uma lista fixa de impostos definida pela Uappi.<\/p>\n\n\n\n

                  Campos da resposta<\/strong><\/h2>\n\n\n\n
                                  Campo<\/strong><\/td>                                      Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
                  id<\/td>ID num\u00e9rico do produto<\/td><\/tr>
                  indice<\/td>Deve ser exatamente o mesmo indice recebido na requisi\u00e7\u00e3o<\/td><\/tr>
                  precoOriginal<\/td>Pre\u00e7o unit\u00e1rio original recebido pela integra\u00e7\u00e3o<\/td><\/tr>
                  precoFinal<\/td>Pre\u00e7o unit\u00e1rio que dever\u00e1 ser utilizado ap\u00f3s o c\u00e1lculo<\/td><\/tr>
                  taxas<\/td>Lista das taxas aplicadas<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                  \"\"<\/figure>\n\n\n\n

                  Cada objeto de taxas deve possuir:<\/p>\n\n\n\n

                                          Campo<\/strong><\/td>                                    Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
                  nome<\/td>Nome da taxa. Obrigat\u00f3rio quando houver imposto<\/td><\/tr>
                  valor<\/td>Valor da taxa. Obrigat\u00f3rio quando houver imposto<\/td><\/tr>
                  descricao<\/td>Descri\u00e7\u00e3o adicional da taxa. Campo opcional<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                  Quando houver altera\u00e7\u00e3o de pre\u00e7o, o retorno deve conter pelo menos uma taxa v\u00e1lida. Uma resposta com precoFinal diferente de precoOriginal e taxas vazio pode at\u00e9 ter o pre\u00e7o processado, mas o item permanece inv\u00e1lido para a conclus\u00e3o da compra e pode bloquear a finaliza\u00e7\u00e3o do checkout. <\/p>\n\n\n\n

                  Aten\u00e7\u00e3o:<\/strong> precoOriginal e precoFinal representam valores unit\u00e1rios<\/strong>. N\u00e3o envie em precoFinal o valor total do item multiplicado pela quantidade.<\/p>\n\n\n\n

                  Por exemplo, para um produto com:<\/p>\n\n\n\n

                    \n
                  • quantidade: 2;<\/li>\n\n\n\n
                  • precoOriginal: 100.00;<\/li>\n\n\n\n
                  • precoFinal: 118.00;<\/li>\n<\/ul>\n\n\n\n

                    o checkout utilizar\u00e1 2 \u00d7 R$ 118,00<\/strong>.<\/p>\n\n\n\n

                    \n\n\n\n

                    Quando n\u00e3o houver imposto a aplicar<\/strong><\/h2>\n\n\n\n

                    Mesmo quando n\u00e3o houver imposto a aplicar ao item, o servi\u00e7o deve retornar uma resposta v\u00e1lida utilizando HTTP 200.<\/p>\n\n\n\n

                    Nesse caso, precoOriginal e precoFinal devem possuir o mesmo valor e taxas deve ser um array vazio.<\/p>\n\n\n\n

                    \"\"<\/figure>\n\n\n\n

                    Quando os pre\u00e7os s\u00e3o iguais e n\u00e3o existem taxas, a venda pode continuar normalmente sem a exibi\u00e7\u00e3o do detalhamento de impostos.<\/p>\n\n\n\n

                    \n\n\n\n

                    Como o c\u00e1lculo aparece no checkout<\/strong><\/h2>\n\n\n\n

                    Quando o precoFinal retornado pelo integrador \u00e9 diferente do pre\u00e7o original, a Uappi utiliza esse valor como novo pre\u00e7o unit\u00e1rio do produto no checkout.<\/p>\n\n\n\n

                    O imposto, portanto, n\u00e3o \u00e9 acrescentado como uma linha separada ao total da compra<\/strong>. O valor retornado passa a compor o pre\u00e7o do pr\u00f3prio item.<\/p>\n\n\n\n

                    Quando houver taxas aplicadas, o checkout pode apresentar o indicador Impostos<\/strong>, permitindo visualizar o detalhamento retornado pelo integrador.<\/p>\n\n\n\n

                    \"\"<\/figure>\n\n\n\n
                    \n\n\n\n

                    Quais itens participam do c\u00e1lculo?<\/strong><\/h2>\n\n\n\n

                    O c\u00e1lculo considera itens dos tipos:<\/p>\n\n\n\n

                      \n
                    • produto;<\/li>\n\n\n\n
                    • servico.<\/li>\n<\/ul>\n\n\n\n

                      Itens configurados como brinde<\/strong> n\u00e3o participam do c\u00e1lculo.<\/p>\n\n\n\n

                      O frete tamb\u00e9m pode fazer parte das informa\u00e7\u00f5es utilizadas pelo motor:<\/p>\n\n\n\n

                        \n
                      • em opera\u00e7\u00f5es com multiestoque<\/strong>, \u00e9 considerado o frete relacionado ao item;<\/li>\n\n\n\n
                      • em opera\u00e7\u00f5es com estoque \u00fanico<\/strong>, o valor de frete \u00e9 rateado por peso entre os itens.<\/li>\n<\/ul>\n\n\n\n
                        \n\n\n\n

                        Quando o c\u00e1lculo \u00e9 realizado?<\/strong><\/h2>\n\n\n\n

                        A consulta ao servi\u00e7o externo acontece durante a jornada do checkout sempre que a plataforma precisa obter ou atualizar as informa\u00e7\u00f5es de imposto dos itens eleg\u00edveis.<\/p>\n\n\n\n

                        Entre os cen\u00e1rios identificados est\u00e3o:<\/p>\n\n\n\n

                          \n
                        • carregamento do carrinho com item sem imposto calculado;<\/li>\n\n\n\n
                        • inclus\u00e3o de item no carrinho;<\/li>\n\n\n\n
                        • c\u00e1lculo ou altera\u00e7\u00e3o de CEP e frete;<\/li>\n\n\n\n
                        • avan\u00e7o pelas etapas de endere\u00e7o e pagamento quando houver item pendente de c\u00e1lculo;<\/li>\n\n\n\n
                        • determinadas altera\u00e7\u00f5es de item ou pre\u00e7o que exijam um novo c\u00e1lculo.<\/li>\n<\/ul>\n\n\n\n

                          O objetivo \u00e9 garantir que os itens eleg\u00edveis estejam com o c\u00e1lculo sincronizado antes da finaliza\u00e7\u00e3o da compra.<\/p>\n\n\n\n

                          \n\n\n\n

                          O que acontece quando a sincroniza\u00e7\u00e3o falha?<\/strong><\/h2>\n\n\n\n

                          O retorno do servi\u00e7o precisa utilizar HTTP 200 e possuir uma estrutura JSON v\u00e1lida.<\/p>\n\n\n\n

                          Respostas com outros status HTTP, timeout ou JSON inv\u00e1lido n\u00e3o s\u00e3o utilizadas para aplica\u00e7\u00e3o dos impostos. Nesses casos, o item pode permanecer sem c\u00e1lculo e impedir a finaliza\u00e7\u00e3o da compra.<\/p>\n\n\n\n

                          Quando ocorre uma falha de sincroniza\u00e7\u00e3o, o checkout pode apresentar:<\/p>\n\n\n\n

                          Houve um problema na sincroniza\u00e7\u00e3o dos impostos. Clique aqui para sincronizar novamente!<\/strong><\/p>\n\n\n\n

                          Ao solicitar a nova sincroniza\u00e7\u00e3o, o checkout realiza uma nova tentativa de consulta.<\/p>\n\n\n\n

                          \"\"<\/figure>\n\n\n\n
                          \n\n\n\n

                          Valida\u00e7\u00e3o na finaliza\u00e7\u00e3o da compra<\/strong><\/h2>\n\n\n\n

                          Antes de concluir a compra, a Uappi verifica se os itens que precisam participar do c\u00e1lculo possuem uma resposta correspondente.<\/p>\n\n\n\n

                          O indice retornado pelo servi\u00e7o deve ser exatamente igual ao recebido na requisi\u00e7\u00e3o. Caso contr\u00e1rio, a Uappi n\u00e3o consegue relacionar o resultado ao item do carrinho.<\/p>\n\n\n\n

                          Se um item permanecer sem imposto calculado, a finaliza\u00e7\u00e3o pode ser bloqueada com a mensagem:<\/p>\n\n\n\n

                          Um ou mais produtos do carrinho, n\u00e3o possuem imposto calculado.<\/strong><\/p>\n\n\n\n

                          \n\n\n\n

                          Depois da gera\u00e7\u00e3o do pedido<\/strong><\/h2>\n\n\n\n

                          Quando existe diferen\u00e7a entre precoOriginal e precoFinal, a Uappi armazena as informa\u00e7\u00f5es relacionadas ao c\u00e1lculo junto ao pedido.<\/p>\n\n\n\n

                          Entre os dados registrados est\u00e3o:<\/p>\n\n\n\n

                            \n
                          • valor unit\u00e1rio original;<\/li>\n\n\n\n
                          • valor unit\u00e1rio final;<\/li>\n\n\n\n
                          • valor total;<\/li>\n\n\n\n
                          • taxas aplicadas.<\/li>\n<\/ul>\n\n\n\n

                            A persist\u00eancia dessas informa\u00e7\u00f5es \u00e9 realizada pela pr\u00f3pria Uappi ap\u00f3s a gera\u00e7\u00e3o do pedido.<\/p>\n\n\n\n

                            O detalhamento pode ser apresentado posteriormente no pedido do painel administrativo e na \u00e1rea Minha Conta<\/strong> do cliente enquanto o recurso de c\u00e1lculo de impostos permanecer ativo. <\/p>\n\n\n\n

                            \"\"<\/figure>\n\n\n\n
                            \n\n\n\n

                            Checklist para homologa\u00e7\u00e3o<\/strong><\/h2>\n\n\n\n

                            Antes de colocar a integra\u00e7\u00e3o em produ\u00e7\u00e3o, valide se:<\/p>\n\n\n\n

                              \n
                            • o endpoint aceita requisi\u00e7\u00f5es POST em JSON;<\/li>\n\n\n\n
                            • a resposta utiliza HTTP 200;<\/li>\n\n\n\n
                            • o retorno ocorre em at\u00e9 60 segundos;<\/li>\n\n\n\n
                            • existe um objeto em taxasItens para cada item recebido;<\/li>\n\n\n\n
                            • indice e id s\u00e3o devolvidos para cada item;<\/li>\n\n\n\n
                            • o indice \u00e9 exatamente o mesmo recebido na requisi\u00e7\u00e3o;<\/li>\n\n\n\n
                            • precoOriginal corresponde ao valor unit\u00e1rio recebido;<\/li>\n\n\n\n
                            • precoFinal representa o valor unit\u00e1rio<\/strong> ap\u00f3s o c\u00e1lculo;<\/li>\n\n\n\n
                            • itens sem imposto retornam precoFinal igual a precoOriginal e taxas vazio;<\/li>\n\n\n\n
                            • itens com altera\u00e7\u00e3o de pre\u00e7o retornam pelo menos uma taxa v\u00e1lida;<\/li>\n\n\n\n
                            • cada taxa possui nome e valor preenchidos;<\/li>\n\n\n\n
                            • o ERP ou motor possui as informa\u00e7\u00f5es fiscais necess\u00e1rias para realizar o c\u00e1lculo, j\u00e1 que dados como NCM n\u00e3o s\u00e3o enviados pela Uappi;<\/li>\n\n\n\n
                            • todos os itens enviados recebem um objeto correspondente na resposta.<\/li>\n<\/ul>\n\n\n\n

                              Um item enviado e n\u00e3o retornado corretamente pode permanecer sem imposto e bloquear a finaliza\u00e7\u00e3o do checkout.<\/p>\n\n\n\n

                              \n\n\n\n

                              Perguntas frequentes<\/strong><\/h2>\n\n\n\n

                              Em quais modelos de neg\u00f3cio o c\u00e1lculo de impostos sobre produtos funciona?<\/strong><\/p>\n\n\n\n

                              O recurso \u00e9 exclusivo para lojas configuradas no modelo de neg\u00f3cio B2B<\/strong>. Ele n\u00e3o \u00e9 executado em lojas B2C ou B2B2C<\/strong>. <\/p>\n\n\n\n

                              O ERP ou integrador precisa disponibilizar uma URL?<\/strong><\/h3>\n\n\n\n

                              Sim. A URL de consulta<\/strong> configurada no App deve apontar para um servi\u00e7o compat\u00edvel com o contrato da integra\u00e7\u00e3o.<\/p>\n\n\n\n

                              Esse servi\u00e7o receber\u00e1 os dados enviados pela Uappi, realizar\u00e1 o c\u00e1lculo e devolver\u00e1 o resultado.<\/p>\n\n\n\n

                              A Uappi realiza o c\u00e1lculo dos impostos?<\/strong><\/h3>\n\n\n\n

                              N\u00e3o. O c\u00e1lculo fiscal \u00e9 responsabilidade do servi\u00e7o externo. A Uappi envia as informa\u00e7\u00f5es dispon\u00edveis e aplica os valores retornados pelo motor no checkout.<\/p>\n\n\n\n

                              A Uappi envia NCM, CFOP, CST e CEST?<\/strong><\/h3>\n\n\n\n

                              N\u00e3o. Essas informa\u00e7\u00f5es n\u00e3o fazem parte do payload desta integra\u00e7\u00e3o. O servi\u00e7o externo deve possuir o cadastro e as regras fiscais necess\u00e1rias e pode utilizar informa\u00e7\u00f5es como sku ou id para identificar o produto.<\/p>\n\n\n\n

                              O<\/strong> precoFinal<\/strong> deve ser unit\u00e1rio ou o total do item?<\/strong><\/h3>\n\n\n\n

                              Unit\u00e1rio.<\/p>\n\n\n\n

                              A Uappi utiliza precoFinal como pre\u00e7o unit\u00e1rio do produto. A quantidade \u00e9 considerada posteriormente na totaliza\u00e7\u00e3o do checkout.<\/p>\n\n\n\n

                              O que devo retornar quando o produto n\u00e3o possuir imposto?<\/strong><\/h3>\n\n\n\n

                              O item ainda deve ser devolvido dentro de taxasItens, utilizando o mesmo indice, com precoFinal igual a precoOriginal e taxas como um array vazio.<\/p>\n\n\n\n

                              O que acontece se um item n\u00e3o for devolvido pelo integrador?<\/strong><\/h3>\n\n\n\n

                              O item pode permanecer sem imposto calculado. Se a Uappi n\u00e3o conseguir relacionar o retorno ao item correspondente, a finaliza\u00e7\u00e3o da compra pode ser bloqueada.<\/p>\n\n\n\n

                              Brindes entram no c\u00e1lculo?<\/strong><\/h3>\n\n\n\n

                              N\u00e3o. Itens configurados como brinde n\u00e3o participam da consulta de impostos.<\/p>\n\n\n\n

                              O c\u00e1lculo de impostos emite nota fiscal?<\/strong><\/h3>\n\n\n\n

                              N\u00e3o. A integra\u00e7\u00e3o trata do c\u00e1lculo dos valores que ser\u00e3o utilizados no checkout. A emiss\u00e3o fiscal n\u00e3o faz parte da responsabilidade desse motor.<\/p>\n\n\n\n

                              <\/p>","protected":false},"excerpt":{"rendered":"

                              O recurso Impostos sobre produto permite integrar o checkout da Uappi a um servi\u00e7o externo respons\u00e1vel pelo c\u00e1lculo de impostos dos itens do carrinho. Nesse fluxo, a Uappi envia os dados dispon\u00edveis do carrinho para o servi\u00e7o configurado pela loja. O servi\u00e7o externo realiza o c\u00e1lculo e devolve o pre\u00e7o unit\u00e1rio calculado e as taxas […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[84,23],"tags":[90,50,51],"modelo-negocio":[],"plataforma":[],"class_list":["post-6008","post","type-post","status-publish","format-standard","hentry","category-apps","category-configuracao","tag-configuracoes","tag-produtos","tag-uappi"],"acf":[],"yoast_head":"\nComo configurar o c\u00e1lculo de impostos sobre produtos – Uappi Helpcenter<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/helpcenter.uappi.com.br\/en\/como-configurar-o-calculo-de-impostos-sobre-produtos\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Como configurar o c\u00e1lculo de impostos sobre produtos – Uappi Helpcenter\" \/>\n<meta property=\"og:description\" content=\"O recurso Impostos sobre produto permite integrar o checkout da Uappi a um servi\u00e7o externo respons\u00e1vel pelo c\u00e1lculo de impostos dos itens do carrinho. Nesse fluxo, a Uappi envia os dados dispon\u00edveis do carrinho para o servi\u00e7o configurado pela loja. O servi\u00e7o externo realiza o c\u00e1lculo e devolve o pre\u00e7o unit\u00e1rio calculado e as taxas […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/helpcenter.uappi.com.br\/en\/como-configurar-o-calculo-de-impostos-sobre-produtos\/\" \/>\n<meta property=\"og:site_name\" content=\"Uappi Helpcenter\" \/>\n<meta property=\"article:published_time\" content=\"2026-09-02T19:49:27+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-09-03T13:02:55+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1536\" \/>\n\t<meta property=\"og:image:height\" content=\"1024\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Thais Teixeira\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Thais Teixeira\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"13 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/\"},\"author\":{\"name\":\"Thais Teixeira\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#\/schema\/person\/7f20a44083ac63de40086c0947a48e7e\"},\"headline\":\"Como configurar o c\u00e1lculo de impostos sobre produtos\",\"datePublished\":\"2026-09-02T19:49:27+00:00\",\"dateModified\":\"2026-09-03T13:02:55+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/\"},\"wordCount\":2216,\"commentCount\":0,\"image\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18-1024x683.png\",\"keywords\":[\"Configura\u00e7\u00f5es\",\"produtos\",\"uappi\"],\"articleSection\":[\"Apps\",\"Configura\u00e7\u00e3o\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/\",\"url\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/\",\"name\":\"Como configurar o c\u00e1lculo de impostos sobre produtos – Uappi Helpcenter\",\"isPartOf\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18-1024x683.png\",\"datePublished\":\"2026-09-02T19:49:27+00:00\",\"dateModified\":\"2026-09-03T13:02:55+00:00\",\"author\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#\/schema\/person\/7f20a44083ac63de40086c0947a48e7e\"},\"breadcrumb\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#primaryimage\",\"url\":\"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18-1024x683.png\",\"contentUrl\":\"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18-1024x683.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/helpcenter.uappi.com.br\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Como configurar o c\u00e1lculo de impostos sobre produtos\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#website\",\"url\":\"https:\/\/helpcenter.uappi.com.br\/\",\"name\":\"Uappi Helpcenter\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/helpcenter.uappi.com.br\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#\/schema\/person\/7f20a44083ac63de40086c0947a48e7e\",\"name\":\"Thais Teixeira\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/0741a3c5fada0dd382023fb5b238543799ecaa0bbf2c7358700ca404452e792d?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/0741a3c5fada0dd382023fb5b238543799ecaa0bbf2c7358700ca404452e792d?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/0741a3c5fada0dd382023fb5b238543799ecaa0bbf2c7358700ca404452e792d?s=96&d=mm&r=g\",\"caption\":\"Thais Teixeira\"},\"url\":\"https:\/\/helpcenter.uappi.com.br\/en\/author\/thaisteixeira\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Como configurar o c\u00e1lculo de impostos sobre produtos – Uappi Helpcenter","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/helpcenter.uappi.com.br\/en\/como-configurar-o-calculo-de-impostos-sobre-produtos\/","og_locale":"en_US","og_type":"article","og_title":"Como configurar o c\u00e1lculo de impostos sobre produtos – Uappi Helpcenter","og_description":"O recurso Impostos sobre produto permite integrar o checkout da Uappi a um servi\u00e7o externo respons\u00e1vel pelo c\u00e1lculo de impostos dos itens do carrinho. Nesse fluxo, a Uappi envia os dados dispon\u00edveis do carrinho para o servi\u00e7o configurado pela loja. O servi\u00e7o externo realiza o c\u00e1lculo e devolve o pre\u00e7o unit\u00e1rio calculado e as taxas […]","og_url":"https:\/\/helpcenter.uappi.com.br\/en\/como-configurar-o-calculo-de-impostos-sobre-produtos\/","og_site_name":"Uappi Helpcenter","article_published_time":"2026-09-02T19:49:27+00:00","article_modified_time":"2026-09-03T13:02:55+00:00","og_image":[{"width":1536,"height":1024,"url":"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18.png","type":"image\/png"}],"author":"Thais Teixeira","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Thais Teixeira","Est. reading time":"13 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#article","isPartOf":{"@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/"},"author":{"name":"Thais Teixeira","@id":"https:\/\/helpcenter.uappi.com.br\/#\/schema\/person\/7f20a44083ac63de40086c0947a48e7e"},"headline":"Como configurar o c\u00e1lculo de impostos sobre produtos","datePublished":"2026-09-02T19:49:27+00:00","dateModified":"2026-09-03T13:02:55+00:00","mainEntityOfPage":{"@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/"},"wordCount":2216,"commentCount":0,"image":{"@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#primaryimage"},"thumbnailUrl":"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18-1024x683.png","keywords":["Configura\u00e7\u00f5es","produtos","uappi"],"articleSection":["Apps","Configura\u00e7\u00e3o"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/","url":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/","name":"Como configurar o c\u00e1lculo de impostos sobre produtos – Uappi Helpcenter","isPartOf":{"@id":"https:\/\/helpcenter.uappi.com.br\/#website"},"primaryImageOfPage":{"@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#primaryimage"},"image":{"@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#primaryimage"},"thumbnailUrl":"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18-1024x683.png","datePublished":"2026-09-02T19:49:27+00:00","dateModified":"2026-09-03T13:02:55+00:00","author":{"@id":"https:\/\/helpcenter.uappi.com.br\/#\/schema\/person\/7f20a44083ac63de40086c0947a48e7e"},"breadcrumb":{"@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#primaryimage","url":"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18-1024x683.png","contentUrl":"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2026\/09\/image-18-1024x683.png"},{"@type":"BreadcrumbList","@id":"https:\/\/helpcenter.uappi.com.br\/como-configurar-o-calculo-de-impostos-sobre-produtos\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/helpcenter.uappi.com.br\/"},{"@type":"ListItem","position":2,"name":"Como configurar o c\u00e1lculo de impostos sobre produtos"}]},{"@type":"WebSite","@id":"https:\/\/helpcenter.uappi.com.br\/#website","url":"https:\/\/helpcenter.uappi.com.br\/","name":"Uappi Helpcenter","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/helpcenter.uappi.com.br\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/helpcenter.uappi.com.br\/#\/schema\/person\/7f20a44083ac63de40086c0947a48e7e","name":"Thais Teixeira","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/0741a3c5fada0dd382023fb5b238543799ecaa0bbf2c7358700ca404452e792d?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/0741a3c5fada0dd382023fb5b238543799ecaa0bbf2c7358700ca404452e792d?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/0741a3c5fada0dd382023fb5b238543799ecaa0bbf2c7358700ca404452e792d?s=96&d=mm&r=g","caption":"Thais Teixeira"},"url":"https:\/\/helpcenter.uappi.com.br\/en\/author\/thaisteixeira\/"}]}},"_links":{"self":[{"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/posts\/6008","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/comments?post=6008"}],"version-history":[{"count":2,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/posts\/6008\/revisions"}],"predecessor-version":[{"id":6038,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/posts\/6008\/revisions\/6038"}],"wp:attachment":[{"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/media?parent=6008"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/categories?post=6008"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/tags?post=6008"},{"taxonomy":"modelo-negocio","embeddable":true,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/modelo-negocio?post=6008"},{"taxonomy":"plataforma","embeddable":true,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/plataforma?post=6008"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}