Fiskey by P3 · NF-e e NFC-e por API
Emita NF-e e NFC-e com poucas linhas: envie a nota em JSON, receba na mesma chamada a resposta da SEFAZ, com chave, protocolo e XML. Acompanhe tudo pelo portal.
Produto
O Fiskey assina, transmite e guarda as notas dos seus emitentes. Seu sistema conversa com a API; sua equipe e seus clientes acompanham pelo portal.
Autenticação por chave de API no cabeçalho X-Api-Key. Cada chamada volta com o desfecho da SEFAZ.
Tudo o que passou pela API, visível para quem precisa ver.
Documentos
Modelo 55
Nota fiscal eletrônica de produtos, com o layout da SEFAZ em JSON e resposta síncrona.
POST /api/v1/nfe
Modelo 65
Nota fiscal de consumidor para o varejo, com o CSC do emitente cadastrado no Fiskey.
POST /api/v1/nfce
Eventos
Cancele uma nota, corrija com carta de correção ou inutilize uma faixa de números pela API ou pelo portal.
Serviços
Nota fiscal de serviços, inclusive no Padrão Nacional.
Transporte
Manifesto e conhecimento de transporte, com os documentos complementares.
Como funciona
Informe o CNPJ e envie o certificado A1. Uma conta pode ter vários emitentes.
Crie a chave no portal e use no cabeçalho X-Api-Key das chamadas.
Nos mesmos campos do layout da SEFAZ. O Fiskey preenche o emitente e a numeração.
Na mesma resposta: status, chave de acesso, protocolo. O XML fica disponível para download.
API
Mande a nota com uma referência sua, como o número do pedido. O Fiskey preenche o emitente e a numeração, assina, transmite e devolve o desfecho.
POST /api/v1/nfePOST /api/v1/nfcePOST /api/v1/documentos/{id}/cancelamentoPOST /api/v1/documentos/{id}/carta-correcaoPOST /api/v1/inutilizacoesGET /api/v1/documentos/{id}/xmlGET /api/v1/sefaz/statusPOST /api/v1/nfe
X-Api-Key: sua-chave-de-api
Content-Type: application/json
{
"referencia": "pedido-1042",
"nota": {
"ide": { "natOp": "Venda" },
"dest": {
"CPF": "12345678909",
"xNome": "Cliente Exemplo",
"indIEDest": 9
},
"det": [{
"prod": { "cProd": "1", "xProd": "Camiseta",
"NCM": "61091000", "CFOP": "5102",
"uCom": "UN", "qCom": 1,
"vUnCom": 59.90, "vProd": 59.90 },
"imposto": { /* ICMS, PIS, COFINS */ }
}],
"total": { "ICMSTot": { "vProd": 59.90, "vNF": 59.90 } },
"pag": { "detPag": [{ "tPag": "01", "vPag": 59.90 }] }
}
}201 Created
{
"modelo": "nfe",
"referencia": "pedido-1042",
"status": "Autorizada",
"cStat": "100",
"motivo": "Autorizado o uso da NF-e",
"chave": "52261012345678000195550010000000011000000012",
"protocolo": "152260000000001",
"numero": 1,
"serie": 1,
"valorTotal": 59.90
}
// O XML autorizado: GET /api/v1/documentos/{id}/xmlExemplo ilustrativo, com dados fictícios. O emitente e a numeração são preenchidos pela API.
Segurança e confiabilidade
Rede cai, a SEFAZ demora, o sistema reenvia. O Fiskey foi desenhado para que nada disso vire nota duplicada, número perdido ou nota em dúvida.
Repetiu a chamada com a mesma referência? A nota autorizada nunca é transmitida duas vezes: a API devolve a mesma nota.
Nota rejeitada e reenviada usa o mesmo número. A série segue em ordem, sem lacunas.
Ficou sem resposta da SEFAZ? O Fiskey consulta sozinho até ter o desfecho.
Cada conta só enxerga os próprios emitentes. Cada usuário e cada chave, só o que lhes cabe.
O certificado digital do emitente fica guardado cifrado, usado só para assinar e transmitir.
Para quem
Coloque a emissão dentro do seu sistema. Cada cliente seu é um emitente, com certificado e série próprios, todos numa só conta.
Acompanhe as notas dos seus clientes num lugar só e dê a cada um acesso só-leitura às notas do próprio CNPJ.
Emita as próprias notas a partir do seu sistema ou da sua loja, com a mesma API e o mesmo portal.
Em breve
Próximos passos do Fiskey. Ainda não estão disponíveis.
Inclusive no Padrão Nacional.
A representação impressa da nota, pronta para entregar.
Seu sistema avisado quando a nota mudar de situação.
XML e PDF enviados ao destinatário.
Os documentos de transporte e os complementares.
Ciência, confirmação e demais eventos sobre as notas recebidas.
Entre no portal para cadastrar o emitente e gerar a chave de API, ou fale com a P3.