TOTVS Motor Fiscal

Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 10 Próxima »

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):
Json_entrada_nfe400
{
    "tipoAcao": "EMISSAO",
    "modelo": 55,
    "emitente": "EMIT002",
    "transportadora": "TELEMACO001",
    "destinatario": "TELEMACO002",
    "retirada": "TELEMACO003",
    "entrega": "TELEMACO004",
    "indicadorConsumidorFinal": 0,
    "indicadorPresencaComprador": 9,
    "indicadorIntermediario": 0,
    "pessoasAutorizadasXml": [
        {
            "documento": "7619873698763418"
        }
    ],
    "produtos": [
        {
            "valor": 10.0,
            "quantidade": 2.0,
            "codigo": "servico",
            "cfop": "5101",
            "quantidadeComercial": 1015.00,
            "valorUnitario": 20.7988965517,
            "unidadeTributavel": "UN",
            "quantidadeTributavel": 35.00,
            "valorUnitarioTributavel": 603.1679971429,
            "numeroPedidoCliente": "14751/22-04",
            "numeroPedidoItemCliente": 10
        }
    ],
    "urlRetorno": "https://teste.free.beeceptor.com",
    "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 Dados mínimos precisam ser preenchidos)


Observações

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

         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

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

  • Sem rótulos