Docs/Notas recebidas
Notas recebidas — DistDFe e manifestação
Capture NF-e emitidas contra o CNPJ da sua empresa, sincronize com a SEFAZ e manifeste o destinatário (ciência automática no sync).
Ver requisitos de autenticaçãoPré-requisitos
- Certificado digital A1 válido na empresa
- Feature
features.inboundNfeliberada pelo suporte Emitfy - Módulo NF-e ativo (
settings.nfe.active)
A ciência da operação (210210) ocorre automaticamente no sync. Este endpoint de manifesto expõe apenas aceite, desconhecimento e operação não realizada.
Headers
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Query params
page
numberopcionalPágina atual. Padrão: 1.
limit
numberopcionalItens por página (máx. 50). Padrão: 15.
search
stringopcionalBusca por emitente, documento ou chave de acesso.
status
stringopcionalpending | science | confirmed | unknown | notPerformed
startDate
numberopcionalInício do período (epoch ms).
endDate
numberopcionalFim do período (epoch ms).
curl -X GET "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/received-nfes?status=pending&page=1&limit=20" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
{
"success": true,
"data": {
"items": [
{
"id": "018f...",
"accessKey": "35260...",
"manifestationStatus": "pending",
"amount": 1500.5,
"issuer": { "name": "Fornecedor LTDA", "taxId": "12345678000199" }
}
],
"pageInfo": { "page": 1, "pages": 1, "limit": 20, "total": 1 }
}
}{
"success": false,
"error": {
"code": "INBOUND_NFE_NOT_ENABLED",
"message": "Notas recebidas não estão liberadas para esta empresa."
}
}Headers
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
curl -X POST "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/received-nfes/sync" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
{
"success": true,
"data": {
"companyId": "018f...",
"accepted": true,
"message": "Sincronização enfileirada."
}
}{
"success": false,
"error": {
"code": "INBOUND_NFE_NOT_ENABLED",
"message": "Notas recebidas não estão liberadas para esta empresa."
}
}Headers
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Parâmetros de rota
id
string (UUID)obrigatórioIdentificador único da nota recebida.
curl -X GET "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/received-nfes/ID_DA_NOTA" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
{
"success": true,
"data": {
"id": "018f...",
"accessKey": "35260...",
"manifestationStatus": "confirmed",
"amount": 1500.5,
"issuer": { "name": "Fornecedor LTDA", "taxId": "12345678000199" }
}
}{
"success": false,
"error": {
"code": "INBOUND_NFE_NOT_ENABLED",
"message": "Notas recebidas não estão liberadas para esta empresa."
}
}Headers
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Parâmetros de rota
id
string (UUID)obrigatórioIdentificador único da nota recebida.
curl -X GET "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/received-nfes/ID_DA_NOTA/xml" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
{
"success": true,
"data": {
"xml": "<?xml version=\"1.0\"?>...",
"accessKey": "35260...",
"xmlUrl": "https://..."
}
}{
"success": false,
"error": {
"code": "INBOUND_NFE_NOT_ENABLED",
"message": "Notas recebidas não estão liberadas para esta empresa."
}
}Headers
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Parâmetros de rota
id
string (UUID)obrigatórioIdentificador único da nota recebida.
Parâmetros do body
type
stringobrigatórioconfirmed | unknown | notPerformed
justification
stringopcionalObrigatório para notPerformed (15–255 caracteres).
curl -X POST "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/received-nfes/ID_DA_NOTA/manifest" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"type": "confirmed"
}'{
"success": true,
"data": {
"id": "018f...",
"accessKey": "35260...",
"manifestationStatus": "confirmed",
"amount": 1500.5,
"issuer": { "name": "Fornecedor LTDA", "taxId": "12345678000199" }
}
}{
"success": false,
"error": {
"code": "INBOUND_NFE_NOT_ENABLED",
"message": "Notas recebidas não estão liberadas para esta empresa."
}
}Tipos de manifesto
type | Evento SEFAZ | Observação |
|---|---|---|
confirmed | 210200 | Confirmação da operação |
unknown | 210220 | Desconhecimento da operação |
notPerformed | 210240 | Exige justification (15–255 caracteres) |