Histórico da Página

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

Modelo JSON (envio):

Bloco de código

language	java
title	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.

código: (01) descrição: "Nota avulsa"
código: (04) descrição: "Nota produtor"
código: (55) descrição: "

Nota produtor

NF-e"
código: (65) descrição: "NFC-e"
código: (57) descrição: "CT-e"
código: (

04

58) descrição: "

Nota produtor

MDF-e"
código: (

04

59) descrição: "

Nota produtor

CF-e"
código: (

04

67) descrição: "

Nota produtor

CT-e OS"
código: (

04

99) descrição: "

Nota produtor

NFSe"

territorioDestino

Caso não informe este campo, o território utilizado na escolha do melhor cenário será o endereço principal do Recebedor ou Destinatário

Regras:

Caso informe a tag territorioDestino, independente de apresentar os atores: Recebedor e/ou Destino, para a escolha do melhor cenário é utilizado o endereço preenchido no territorioDestino;
Caso informe os atores de Destino: Recebedor e Destinatário e não informe o territórioDestino, para a escolha do melhor cenário é utilizado o endereço principal do ator Recebedor;
Caso não informe o territorioDestino Recebedor e Destinatário ocorre o erro:
{
    "status": 400,
    "timestamp": "2022-12-01T14:44:47.969961",
    "title": "Erro em regra de negocio.",
    "detail": "Não foi possível encontrar Território de Destino. Informe os dados de Território Destino, Recebedor ou Destinatario"
}

tomador


emitente	Identificação do emitente
transportadora	Dados do transportador
destinatario	Identificação do Destinatário
retirada	Identificação do Local de Retirada (informar apenas quando for diferente do endereço do remetente)
entrega	Identificação 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 oepraçã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	Pessoas autorizadas para o download do XML da NF-e Na tag documento deve enviar CNPJ ou RG
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

O tomador (indTomador) está sendo incluído de acordo com as regras abaixo:

Se o código do tomador for igual ao Remetente então será incluído no xml toma3 = 0, sendo o tomador o remetente;

Se o código do tomador for igual ao Expedidor então será incluído no xml toma3 = 1, sendo o tomador o expedidor;

Se o código do tomador for igual ao Recebedor então será incluído no xml toma3 = 2, sendo o tomador o recebedor;

Se o código do tomador for igual ao Destinatário então será incluído no xml toma3 = 3, sendo o tomador o destinatário;

Se o código do tomador não for igual a nenhum dos atores então será incluído no xml toma4;

Não é um campo obrigatório para o Cálculo, porém é obrigatório para ser autorizado na Sefaz;

Árvore de páginas

Versões comparadas

Versão antiga 5

Nova versão 6

Chave