TOTVS Motor Fiscal

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Paulo Henrique dos Reis_

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Amanda Georgia Mamede

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Endpoint:Ambiente Stage: https://stg.motorfiscal.raas.varejo.totvs.com.br/starting/api/v1/operacao-nfe
Método:POST
Descrição:Utilize este recurso para inserir um novo registro NF-e
Modelo JSON (envio):

{
    "tipoAcao": "EMISSAO",
    "modelo": "55",
    "emitente": "EMIT001",
    "destinatario": "ATOR002",
    "indicadorConsumidorFinal": 0,
    "indicadorPresencaComprador": 9,
    "indicadorIntermediario": 0,
    "numeroFatura": "123",
    "username": "teste@totvs.com.br",
    "urlRetorno": "https://retorno-webhook.free.beeceptor.com",
    "transportadora": {
        "modFrete": "9"
    },
    "cobranca": {
        "fat": {
            "nFat": 10438,
            "vOrig": 399.90,
            "vDesc": 0.00,
            "vLiq": 399.90
        }
    },
    "pagamento": {
        "detPag": [
            {
                "tPag": "15",
                "vPag": 399.90,
                "card": {
                    "tpIntegra": 2
                }
            }
        ]
    },
    "pessoasAutorizadasXml": [
        {
            "documento": "7619873698763418"
        }
    ],
    "produtos": [
        {
            "valor": 399.990,
            "quantidade": 1.0,
            "codigo": "NAT1589",
            "cfop": "6101",
            "quantidadeComercial": 1.0,
            "valorUnitario": 399.990,
            "unidadeTributavel": 1.0,
            "quantidadeTributavel": 1.0,
            "valorUnitarioTributavel": 399.990,
            "numeroPedidoCliente": "14751/22-04",
            "numeroPedidoItemCliente": 10,
            "valorFrete": 0.000,
            "indTotal": true
        }
    ],
    "observacoesGerais": [
        "A geração da Nota Fiscal de Serviços Eletrônica é feita, automaticamente, por meio de serviços informatizados, disponibilizados"
    ],
    "observacoesFisco": [
        "Desconto de: 0,20 % sobre 21.110,88 Ate 17/05/2024Pagto: 28 DD Indice Financ.: 1,0131 Repres: 10631 - AALVES/FAP @ ONU 9999 - PRODUTO NAO CLASSIFICADO PARA TRANSPORTE N.A/N.D 1.015,00 Declaro que os produtos perigosos estao adequadamente classificados, embalados, identificados, e estivados para suportar os riscos das operacoes de transporte e que atendem as exigencias da regulamentacao em 19/04/2024.(Tel.Transp.: 043- 999244580)** ATENCAO: OS BOLETOS SAO ENVIADOS SOMENTE POR E-MAIL: [email protected], CASO NAO RECEBA O BOLETO, FAVOR ENTRAR EM CONTATO 011-2117-9020 **"
    ]
}

Status de retorno:
  • 200 - OK
  • 400 - Bad Request (Um ou mais campos estão inválidos. Faça o preenchimento correto e tente novamente)
  • 401 - Unauthorized (Falha na autenticação)
  • 500 - Internal Error (Falha de comunicação com a fila: fiscal-motor-starting-calculating-operacao-nfe-topic ou ou Dados mínimos precisam ser preenchidos)

...

Atributo

Exemplo

tipoAcao
  • EMISSAO: Efetua cálculo dos tributos e gera o documento fiscal;
  • SIMULACAO: Efetua cálculo dos tributos e retorna apuração dos tributos;
modelo

Modelo do documento: 55 - NF-e

emitenteIdentificar com o ator que deve ser o emissor do documento
transportadora

Identificar com o ator que deve ser o transportador do documento

destinatario

Identificar com o ator que deve ser o destinatário do documento

retirada

Identificar com o ator do Local de Retirada (informar apenas quando for diferente do endereço do emitente)

entrega

Identificar com o ator do Local de Entrega (informar apenas quando for diferente do endereço do destinatário)

indicadorConsumidorFinal

Indica operação com consumidor final (0-Não;1-Consumidor Final)

indicadorPresencaComprador

Indicador de presença do comprador no estabelecimento comercial no momento da operação :

  • 0-Não se aplica (ex.: Nota Fiscal complementar ou de ajuste);
  • 1-Operação presencial;
  • 2-Não presencial, internet;
  • 3-Não presencial, teleatendimento;
  • 4-NFC-e entrega em domicílio;
  • 5-Operação presencial, fora do estabelecimento;
  • 9-Não presencial, outros;
indicadorIntermediario

Indicador de intermediador/marketplace:

  • 0=Operação sem intermediador (em site ou plataforma própria)
  • 1=Operação em site ou plataforma de terceiros (intermediadores/marketplace)
pessoasAutorizadosXml

Informar o CNPJ ou CPF das Pessoas autorizadas para o download do XML da NF-e.

produtos

Dados dos produtos e serviços da NF-e

          valor

Valor do Produto

         quantidade

Quantidade do Produto

         codigo

Código externo do poduto

         cfop

Cfop do produto ou no caso do não preenchimento, será considerado o informado no Cenário

         quantidadeComercial

Quantidade Comercial do produto, alterado para aceitar de 0 a 4 casas decimais e 11 inteiros.

         valorUnitario

Valor unitário de comercialização - alterado para aceitar 0 a 10 casas decimais e 11 inteiros

         unidadeTributavel

Unidade Tributável

         quantidadeTributavel

Quantidade Tributável - alterado para aceitar de 0 a 4 casas decimais e 11 inteiros

         valorUnitarioTributavel

Valor unitário de tributação - - alterado para aceitar 0 a 10 casas decimais e 11 inteiros

         numeroPedidoCliente

Pedido de compra - Informação de interesse do emissor para controle do B2B.

         numeroPedidoItemCliente

Número do Item do Pedido de Compra - Identificação do número do item do pedido de Compra

         valorFrete

Valor do frete

         indTotal

Indicador para inclusão do valor do Produto no Total da Nota

urlRetorno

Url de envio do retorno para o webhook do cliente

observacoesGerais

Campo de uso livre do contribuinte informar o nome do campo no atributo xCampo e o conteúdo do campo no xTexto

observacoesFisco

Campo de uso exclusivo do Fisco informar o nome do campo no atributo xCampo e o conteúdo do campo no xTexto

...