Devolução Nota Fiscal
devolucaoNota
Autorizações
AuthorizationstringObrigatório
Parâmetros de consulta
dataIniciostring | nuloOpcional
Data de Emissão da Devolução Início (YYYY-MM-DD)
dataFimstring | nuloOpcional
Data de Emissão da Devolução Término (YYYY-MM-DD)
clientesstring[] | nuloOpcional
Lista de Códigos de Clientes
motivosDevolucaostring[] | nuloOpcional
Lista de Códigos de Motivos de Devolução
continuationTokenstring | nuloOpcional
Identificador da Paginação da Consulta
Parâmetros de cabeçalho
empresaintegerObrigatório
Empresa para Importação da Devolução
Respostas
200
OK
application/json
400
Bad Request
application/json
429
Too Many Requests
500
Internal Server Error
application/json
get
/devolucaoNotaGET /comercial/v10/devolucaoNota HTTP/1.1
Host: localhost
Authorization: YOUR_API_KEY
empresa: 1
Accept: */*
{
"continuationToken": "text",
"notasDevolucao": [
{
"numeroDocumento": 1,
"dataEntrada": "2025-11-29",
"CNPJCPFCliente": "text",
"chaveNFeNFCe": "text",
"serieFiscal": 1,
"parametroDevolucao": 1,
"motivoDevolucao": 1,
"notasDevolvidas": [
{
"dataNotaDev": "text",
"codNotaDev": 1
}
],
"itensDevolucao": [
{
"sequenciaItem": 1,
"codProduto": "text",
"quantidade": 1,
"precoUnitarioLiquido": 1,
"vlrTotalLiquido": 1,
"vlrDesconto": 1,
"cfop": 1,
"baseICMS": 1,
"aliquotaICMS": 1,
"vlrICMS": 1,
"vlrICMSIsenta": 1,
"vlrICMSOutras": 1,
"cstICMS": "text",
"baseIPI": 1,
"aliquotaIPI": 1,
"vlrIPI": 1,
"vlrIPIIsentas": 1,
"vlrIPIOutras": 1,
"cstIPI": "text",
"cstPIS": "text",
"basePIS": 1,
"aliquotaPIS": 1,
"vlrPIS": 1,
"cstCofins": "text",
"baseCOFINS": 1,
"aliquotaCOFINS": 1,
"vlrCOFINS": 1,
"vlrDIFALRemetente": 1,
"vlrDIFALDestinario": 1,
"vlrDIFALFCP": 1,
"vlrFrete": 1,
"baseST": 1,
"vlrST": 1,
"outrasDespesas": 1,
"dadosCustomizados": [
{
"campo": "text",
"valor": "text"
}
]
}
],
"dadosCustomizados": [
{
"campo": "text",
"valor": "text"
}
]
}
]
}Autorizações
AuthorizationstringObrigatório
Parâmetros de cabeçalho
empresainteger · mín: 1 · máx: 99999Obrigatório
Empresa para Importação da Devolução
Corpo
numeroDocumentointeger · máx: 999999999Obrigatório
Número do Documento
dataEntradastring · dateObrigatório
Data de Entrada (YYYY-MM-DD)
CNPJCPFClientestring · mín: 11 · máx: 14Obrigatório
Código do CPF/CNPJ do Cliente
chaveNFeNFCestring · mín: 44Opcional
Chave de Acesso NF-e/NFC-e
serieFiscalinteger · máx: 999Opcional
Código da Série Fiscal
parametroDevolucaointeger · máx: 999Opcional
Código do Parâmetro da Devolução
motivoDevolucaointeger · mín: 1 · máx: 99Opcional
Código do Motivo da Devolução
Respostas
200
OK
Sem conteúdo
400
Bad Request
application/json
429
Too Many Requests
500
Internal Server Error
application/json
put
/devolucaoNotaPUT /comercial/v10/devolucaoNota HTTP/1.1
Host: localhost
Authorization: YOUR_API_KEY
empresa: 1
Content-Type: application/json
Accept: */*
Content-Length: 895
{
"numeroDocumento": 1,
"dataEntrada": "2025-11-29",
"CNPJCPFCliente": "text",
"chaveNFeNFCe": "text",
"serieFiscal": 1,
"parametroDevolucao": 1,
"motivoDevolucao": 1,
"itensDevolucao": [
{
"sequenciaItem": 1,
"codProduto": "text",
"quantidade": 1,
"precoUnitarioLiquido": 1,
"vlrTotalLiquido": 1,
"vlrDesconto": 1,
"cfop": 1,
"baseICMS": 1,
"aliquotaICMS": 1,
"vlrICMS": 1,
"vlrICMSIsenta": 1,
"vlrICMSOutras": 1,
"cstICMS": "text",
"baseIPI": 1,
"aliquotaIPI": 1,
"vlrIPI": 1,
"vlrIPIIsentas": 1,
"vlrIPIOutras": 1,
"cstIPI": "text",
"cstPIS": "text",
"basePIS": 1,
"aliquotaPIS": 1,
"vlrPIS": 1,
"cstCofins": "text",
"baseCOFINS": 1,
"aliquotaCOFINS": 1,
"vlrCOFINS": 1,
"vlrDIFALRemetente": 1,
"vlrDIFALDestinario": 1,
"vlrDIFALFCP": 1,
"vlrFrete": 1,
"baseST": 1,
"vlrST": 1,
"outrasDespesas": 1,
"dataEmissaoNotaDevolvida": "2025-11-29",
"numeroNotaDevolvida": "text",
"dadosCustomizados": [
{
"campo": "text",
"valor": "text"
}
]
}
],
"dadosCustomizados": [
{
"campo": "text",
"valor": "text"
}
]
}Sem conteúdo
Atualizado