API API - Interface para Integração

API

Se sua empresa já tiver um sistema, você pode emitir uma Nfe através de nosso sistema com a integração

A requisição deverá ser feita através de um comando HTTP Post para o endereço https://app.nfesimples.com/ErpPedidoAPI/V1 informando um corpo de requisição JSON.

Veja o Exemplo abaixo e em caso de dúvidas, entre em contato com suporte@nfesimples.com

{ "notaFiscal": { "apiKey": "952E237FC4D94EEAAAF1445256C8A606", // Disponível na Tela de Emitente "natOp": "venda", // Descrição da Operação da Nfe "dhEmi": "2019-01-01", // Data de Emissão Opcional em AAAA-MM-DD "tpNF": "1", // 1-Saída / 2-Entrada "indFinal": "1", // 1-Consumidor Final / 0-Outros "observacao": "TEXTO", // Texto Livre "xPed": "1234" // Nr. Pedido Cliente (Opcional) 15 Posições "numeroNotaFiscal": "1234" // Informar caso precise alterar um pedido antes de emitir a nota "chaveNotaFiscalDevolucao": "35190205393606000158550000000303951053936060" //Informar em caso de Devolução }, "dest": { "CNPJ": "65722270044361", // CNPJ ou CPF do Destinatário Somente Parte Numerica "CPF": "", // Informar Somente CNPJ ou CPF "xNome": "XPTO INFORMATICA", // Razão Social "xLgr": "Alameda Tocantins", // Endereço Principal - Logradouro "nro": "75 Cj 805", // Endereço Principal - Numero "xCpl": "Alphaville Empresarial", // Endereço Principal - Complemento "xBairro": "Alphaville.", // Endereço Principal - Bairro "cMun": "3550308", // Endereço Principal - Código IBGE "UF": "SP", // Endereço Principal - Sigla do Estado da Federacao "CEP": "06455020", // Endereço Principal - CEP Somente Parte Numerica "fone": "46896925", // Telefone - Somente Parte Numerica com DDD "IE": "206388563114", // Somente parte Numerica - Não informar se Isento "email": "xpto@hotmail.com", // Email Valido "SituacaoIcms": "1", // 1-Contribuinte ICMS / 2-Não Contr. ICMS, c/ ou s/ IE "indConsumidor": "0" }, "entrega": { //Informar se Diferente do Principal "xLgr": "Alameda Tocantins", // Endereço Entrega - Logradouro "nro": "75 Cj 805", // Endereço Entrega - Numero "xCpl": "Alphaville", // Endereço Entrega - Complemento "xBairro": "Alphaville", // Endereço Entrega - Bairro "cMun": "3550308", // Endereço Entrega - Código IBGE "CEP": "06455020", // Endereço Entrega - CEP Somente Parte Numerica "UF": "SP" // Endereço Entrega - Sigla do Estado da Federacao }, "itens": [ { //Informar pelo menos um Item "cProd": "Envio", //Codigo do Produto "Orig": "0", //0 - Nacional //1 - Estrangeira - Importaçao direta //2 - Estrangeira - Adquirida no mercado interno //3 - Nacional - mercadoria ou bem com Conteúdo de Importação // superior a 40% //4 - Nacional - cuja produção tenha sido feita em conformidade // com os processos produtivos básicos de que tratam as // legislações citadas nos Ajustes //5 - Nacional - mercadoria ou bem com Conteúdo de Importação // inferior ou igual a 40% //6 - Estrangeira - Importação direta - sem similar nacional, // constante em lista da CAMEX //7 - Estrangeira - Adquirida no mercado interno - sem similar // nacional, constante em lista da CAMEX //8 - Nacional, mercadoria ou bem com Conteúdo de Importação // superior a 70% "cEAN": "SEM GTIN", // Codigo de Barras ou "SEM GTIN" "xProd": "Taxa de Postagem", //Descricao do Produto "NCM": "00000000", //Codigo do NCM ou sequencia de 8 zeros "CFOP": "6949", //CFOP - Vide tabela SEFAZ "uCom": "UN", //Unidade do Produto // CH / CX / KG / LT / MT / PAR / PC / PCT / PR // RL / TB / UN / BR / DIA "qtde": "1.0000", //Quantidade com até 4 posições decimais "vUnit": "29.00000000", //Valor Unitário com até 8 posições decimais "ICMS": "101", //00-Tributada integralmente //10-Tributada e com cobrança do ICMS por substituição // tributária //20-Com redução de base de cálculo //30-Isenta ou não tributada e com cobrança do ICMS por // substituição tributária //40-Isenta //41-Não tributada //50-Suspensão //51-Diferimento A exigência do preenchimento das // informações do ICMS diferido fica a critério de cada UF //60-ICMS cobrado anteriormente por substituição tributária //70-Com redução de base de cálculo e cobrança do ICMS // por substituição tributária //90-Outros //98-Operação interestadual para consumidor final com // partilha do ICMS devido na operação entre a UF de // origem e a UF do destinatário ou a UF definida na // legislação. (Ex. UF da concessionária de entrega // do veículos) //99-Grupo de informação do ICMS ST devido para a UF // de destino, nas operações interestaduais de produtos // que tiveram retenção antecipada de ICMS por ST // na UF do remetente. Repasse via Substituto Tributário. //101-Tributada pelo Simples Nacional com permissão de crédito //102-Tributada pelo Simples Nacional sem permissão de crédito //103-Isenção do ICMS no Simples Nacional para faixa de receita bruta //201-Tributada pelo Simples Nacional com permissão de // crédito e com cobrança do ICMS por Substituição Tributária //202-Tributada pelo Simples Nacional sem permissão de crédito // e com cobrança do ICMS por Substituição Tributária //203-Isenção do ICMS nos Simples Nacional para faixa de // receita bruta e com cobrança do ICMS por Substituição Tributária //300-Simples Nacional Imune //400-Não tributada pelo Simples Nacional //500-ICMS cobrado anteriormente por substituição tributária (substituído) // ou por antecipação //900-Outras operações Simples Nacional //901-Outras operações Simples Nacional com ICMS "vICMSBase": "29.00000000", "vICMSRedBase": "0.00000000", "pICMS": "18", "vICMSSTBase": "0.0000000", "vICMSST": "0.0000000", "vICMSMotDesoneracao": "0", //01-Táxi //03-Produtor Agropecuário //04-Frotista/Locadora //05-Diplomático/Consular //06-Utilitários e Motocicletas da Amazônia Ocidental e // Áreas de Livre Comércio (Resolução 714/88 e 790/94 – // CONTRAN e suas alterações) //07-SUFRAMA //08-Venda a Órgãos Públicos //09-Outros. (NT 2011/004) //10-Deficiente Condutor (Convênio ICMS 38/12) //11-Deficiente Não Condutor (Convênio ICMS 38/12) //16-Olimpíadas Rio 2016 "vICMSModalidade": "0", //0-Margem Valor Agregado (%) //1-Pauta (Valor) //2-Preço Tabelado Máx. (valor) //3-Valor da operação "vICMSModalidadeST": "0", //0-Preço tabelado ou máximo sugerido //1-Lista Negativa (valor) //2-Lista Positiva (valor) //3-Lista Neutra (valor) //4-Margem Valor Agregado (%) //5-Pauta (valor) "indICMSTot": "1", //Indicacao se os valores ICMS fazem parte do Total "IPI": "99", //00-Entrada com recuperação de crédito //01-Entrada tributada com alíquota zero //02-Entrada isenta //03-Entrada não-tributada //04-Entrada imune //05-Entrada com suspensão //49-Outras entradas //50-Saída tributada //51-Saída tributada com alíquota zero //52-Saída isenta //53-Saída não-tributada //54-Saída imune //55-Saída com suspensão //98-Outras saídas Não Tributadas //99-Outras saídas "vIPIBase": "0.00000000", "pIPI": "0.00000000", "PIS" : "99", //01–Operação Tributável (base de cálculo = valor // da operação alíquota normal (cumulativo/não cumulativo)) //02-Operação Tributável (base de cálculo = // valor da operação (alíquota diferenciada)) //03-Operação Tributável (base de cálculo = quantidade // vendida x alíquota por unidade de produto) //04-Operação Tributável (tributação monofásica // (alíquota zero)) //06-Operação Tributável (alíquota zero) //07-Operação Isenta da Contribuição //08-Operação Sem Incidência da Contribuição //09-Operação com Suspensão da Contribuição //49-Outras Operações de Saída //50-Operação com Direito a Crédito - Vinculada Exclusivamente // a Receita Tributada no Mercado Interno //51-Operação com Direito a Crédito - Vinculada Exclusivamente // a Receita Não Tributada no Mercado Interno //52-Operação com Direito a Crédito – Vinculada Exclusivamente // a Receita de Exportação //53-Operação com Direito a Crédito - Vinculada a Receitas // Tributadas e Não-Tributadas no Mercado Interno //54-Operação com Direito a Crédito - Vinculada a Receitas // Tributadas no Mercado Interno e de Exportação //55-Operação com Direito a Crédito - Vinculada a Receitas // Não-Tributadas no Mercado Interno e de Exportação //56-Operação com Direito a Crédito - Vinculada a Receitas // Tributadas e Não-Tributadas no Mercado Interno, e de Exportação //60-Crédito Presumido - Operação de Aquisição Vinculada // Exclusivamente a Receita Tributada no Mercado Interno //61-Crédito Presumido - Operação de Aquisição Vinculada // Exclusivamente a Receita Não-Tributada no Mercado Interno //62-Crédito Presumido - Operação de Aquisição Vinculada // Exclusivamente a Receita de Exportação //63-Crédito Presumido - Operação de Aquisição Vinculada a // Receitas Tributadas e Não-Tributadas no Mercado Interno //64-Crédito Presumido - Operação de Aquisição Vinculada a // Receitas Tributadas no Mercado Interno e de Exportação //65-Crédito Presumido - Operação de Aquisição Vinculada a // Receitas Não-Tributadas no Mercado Interno e de Exportação //66-Crédito Presumido - Operação de Aquisição Vinculada a // Receitas Tributadas e Não-Tributadas no Mercado Interno, // e de Exportação //67-Crédito Presumido - Outras Operações //70-Operação de Aquisição sem Direito a Crédito //71-Operação de Aquisição com Isenção //72-Operação de Aquisição com Suspensão //73-Operação de Aquisição a Alíquota Zero //74-Operação de Aquisição sem Incidência da Contribuição //75-Operação de Aquisição por Substituição Tributária //98-Outras Operações de Entrada //99-Outras Operações "vPISBase": "0.00000000", "pPIS": "0.00000000", "COFINS": "99", //01–Operação Tributável (base de cálculo = valor // da operação alíquota normal (cumulativo/não cumulativo)); //02-Operação Tributável (base de cálculo = valor da operação // (alíquota diferenciada)); //03-Operação Tributável (base de cálculo = quantidade // vendida x alíquota por unidade de produto); //04-Operação Tributável (tributação monofásica (alíquota zero)); //06-Operação Tributável (alíquota zero); //07-Operação Isenta da Contribuição; //08-Operação Sem Incidência da Contribuição; //09-Operação com Suspensão da Contribuição; //49-Outras Operações de Saída; //50-Operação com Direito a Crédito - Vinculada // Exclusivamente a Receita Tributada no Mercado Interno; //51-Operação com Direito a Crédito - Vinculada // Exclusivamente a Receita Não Tributada no Mercado Interno; //52-Operação com Direito a Crédito – Vinculada // Exclusivamente a Receita de Exportação; //53-Operação com Direito a Crédito -Vinculada a Receitas // Tributadas e Não-Tributadas no Mercado Interno; //54-Operação com Direito a Crédito - Vinculada a Receitas // Tributadas no Mercado Interno e de Exportação; //55-Operação com Direito a Crédito - Vinculada a Receitas // Não-Tributadas no Mercado Interno e de Exportação; //56-Operação com Direito a Crédito - Vinculada a Receitas // Tributadas e Não-Tributadas no Mercado Interno, e de Exportação; //60-Crédito Presumido - Operação de Aquisição Vinculada // Exclusivamente a Receita Tributada no Mercado Interno; //61-Crédito Presumido - Operação de Aquisição Vinculada // Exclusivamente a Receita Não-Tributada no Mercado Interno; //62-Crédito Presumido - Operação de Aquisição Vinculada // Exclusivamente a Receita de Exportação; //63-Crédito Presumido - Operação de Aquisição Vinculada // a Receitas Tributadas e Não-Tributadas no Mercado Interno; //64-Crédito Presumido - Operação de Aquisição Vinculada // a Receitas Tributadas no Mercado Interno e de Exportação; //65-Crédito Presumido - Operação de Aquisição Vinculada // a Receitas Não-Tributadas no Mercado Interno e de Exportação; //66-Crédito Presumido - Operação de Aquisição Vinculada // a Receitas Tributadas e Não-Tributadas no Mercado // Interno, e de Exportação; //67-Crédito Presumido - Outras Operações; //70-Operação de Aquisição sem Direito a Crédito; //71-Operação de Aquisição com Isenção; //72-Operação de Aquisição com Suspensão; //73-Operação de Aquisição a Alíquota Zero; //74-Operação de Aquisição; sem Incidência da Contribuição; //75-Operação de Aquisição por Substituição Tributária; //98-Outras Operações de Entrada; //99-Outras Operações; "vCOFINSBase": "0.00000000", "pCOFINS": "0.00000000", "vSiscomex": "0.00000000", "pII": "0.00000000", "indIITot": "1", //Indicacao do Imposto sob Importação ser incorporado no Total "vAFRMM": "0.0000000", "vDifalBase": "0.0000000", "pDifalIE": "0.0000000", "pDifalCalculo": "0.0000000", "pDifalDestino": "0.0000000", "pFCP": "0.0000000", "vOutros": "0.0000000", "pImpostosLei1274112": "0.0000000", "indTot": "1" //Indicacao se os valores de produto serem incorporados no Total } ], "transp": { "modFrete": "1", //1-Emitente (CIF) / 2-Destinatário (FOB) "especie": "CX", // CX / ROLO / PACOTE / SACOLA / PC / UNID / PALETE / SACO / AMPOLA // BALDE / BANDEJ / BARRA / BISNAG / BLOCO / BOBINA / BOMB / CAPS // CART / CENTO / CJ / CM / CM2 / CX2 / CX3 / CX5 / CX10 / CX15 // CX20 / CX25 / CX50 / CX100 / DISP / DUZIA / EMBAL / FARDO // FOLHA / FRASCO / GALAO / GF / GRAMAS / JOGO / KG / KIT / LATA /// LITRO / M / M2 / M3 / MILHEI / ML / MWH / PARES / POTE / K // RESMA / TAMBOR / TANQUE / TON / TUBO / VASIL / VIDRO "pesoBruto": "0.0000", "pesoLiquido": "0.0000", "frete": "0.0000", "transporta": { "CNPJ": "08068640000145", "xNome": "A Retirar", "IE": "206388563114", "xLgr": "Rua 3, abc", "xBairro": "Jardim Algum", "cMun": "3550308", "CEP": "06455020", "UF": "SP" } }, "parcelas": [ { "dVenc": "2019-01-05", "vParc": "1234.00", "tPag": "90" // 01-Dinheiro / 02-Cheque / 03-Cartão de Crédito // 04-Cartão de Débito / 05-Crédito Loja // 10-Vale Alimentação / 11-Vale Refeição // 12-Vale Presente / 13-Vale Combustível // 15-Boleto Bancario / 90-Sem Pagamento // 99-Outros } ] }

Retorno da Solicitação

Importante: Todo o retorno de solicitação é 200 mesmo sem ter o pedido incluído

Em caso de erro interno retorna 500 e uma mensagem é enviada para o suporte

{ "sucesso": "true" // "false" se não foi incluído "numeroNotaFiscal": 12345 // Retorno da nota fiscal caso tenha sido // feita a reserva de Numero. // Caso não tenha, retorna 0 "chaveAcessoNfe": "51080701212344000127550010000000981364117781" // Retorno da nota fiscal caso tenha sido // feita a reserva de Numero. "mensagemRetorno": "Pedido Incluído com Sucesso" //Mensagem de retorno ou de consistência }