- 🚀 Introdução
- 🔒 Autenticação
- 🚦 Rate Limiting
- 🛟 Suporte
- Autenticação
- Produtos
- 📦 Conceitos de Produtos
- Gerenciamento
- Controle
- Códigos fiscais
- Tipos de Operações
- Clientes
- Pedidos - Gerenciamento
- 🛒 Pedidos Fulfillment
- Gerenciamento
- Workflows
- Itens do Pedido
- Agendamento
- Identificação de Produtos
- Documentos Fiscais
- Documentos para Impressão
- Pedidos - Aguardando NFe
- Configurações
- Locais de Estoque
- Inventário
Detalhes Fiscal
Developing
GET
/api/v1/orders-fiscal/{order_code}
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************Path Params
Responses
🟢200OK
application/json
Body
Examples
{
"success": true,
"message": "Detalhes do pedido fiscal recuperados com sucesso",
"data": {
"order_number": "OUTMKT.2025-08.000001",
"order_type": "out",
"status": "in_progress",
"substatus": {
"value": "awaiting_packing",
"label": "Aguardando Embalagem",
"description": "Pedido aguardando embalagem"
},
"is_confirmed": true,
"is_packed": false,
"warehouse": {
"warehouse_id": 1,
"name": "001 - Pari - SP"
},
"items": [
{
"item_id": 7,
"product": {
"sku": "FD24X50",
"name": "Fita Adesiva Dupla Face 24mm x 50m",
"has_ean": false,
"barcode": "FD24X50-283416",
"description": "Fita adesiva dupla face com 24mm de largura e 50 metros",
"has_serial_number": false,
"has_batch_control": false,
"has_expiration_date": false
},
"origin_fiscal_key": "2512173600444828482166316417544458",
"quantity": 1,
"quantity_processed": 1,
"status": "in_progress",
"batch_number": null,
"serial_number": null,
"additional_data": []
}
],
"customer_owner": {
"customer_id": "01k2qgpk00316cf3gqtrv0v41h",
"name": "Loja Diversificada Mix",
"document": "51115210000166"
},
"operation_type": {
"operation_type_id": 8,
"name": "Pedido de Venda - Marketplace",
"description": "Saída de mercadorias para venda com emissão de NF",
"module": "outbound",
"can_be_created_by_customer": true
},
"recipient_id": "01k2qgpkrt32hqwnksxtjwnjgy",
"recipient": {
"id": "01k2qgpkrt32hqwnksxtjwnjgy",
"name": "Consumidor Final 01",
"email": "customer-01@demo.com",
"document": "12345678901",
"ie": null,
"phone": "(11) 99999-9999"
},
"recipient_address_id": "01k2qgpks1sb9r5h3cnm0newj9",
"recipient_address": {
"id": "01k2qgpks1sb9r5h3cnm0newj9",
"street": "Rua Haddock Lobo",
"number": "150",
"complement": "Apto 11",
"neighborhood": "Cerqueira César",
"city": "São Paulo",
"state": "SP",
"postal_code": null
},
"carrier_id": null,
"schedules": [],
"notes": "Pedido de venda para testar movimentação de saída",
"created_by_id": 2,
"created_by_type": "Administrator",
"creator": null,
"created_at": "2025-08-15T18:43:57.000000Z",
"created_at_formatted": "15/08/2025 15:43",
"updated_at": "2025-08-15T18:43:59.000000Z",
"updated_at_formatted": "15/08/2025 15:43",
"fiscal_requirements": {
"required": true,
"message": "Documentos fiscais obrigatórios:",
"documents": [
{
"workflow_sequence": 2,
"document_type": "nfe_retorno",
"document_type_label": "Nota Fiscal Eletrônica de Retorno",
"workflow_status": "completed",
"workflow_status_info": {
"value": "completed",
"label": "Concluído",
"description": "COMPLETED"
},
"document_uploaded": true,
"document_status": "approved",
"can_be_executed_by_customer": true,
"validation_rules": [
{
"cfop": {
"required": true,
"valid_codes": [
"5102",
"6102",
"5405",
"6405",
"5101",
"6101",
"5401",
"6401",
"5905",
"6905",
"5923",
"6923",
"5906",
"6906",
"5934",
"6934",
"5152",
"6152",
"5153",
"6153",
"5556",
"6556",
"5949",
"6949"
],
"description": "Código Fiscal de Operações e Prestações deve ser um dos valores permitidos",
"cfop_details": [
"5102 - Venda de mercadoria adquirida ou recebida de terceiros",
"6102 - Venda de mercadoria adquirida ou recebida de terceiros",
"5405 - Venda de mercadoria adquirida ou recebida de terceiros em operação com mercadoria sujeita ao regime de substituição tributária, na condição de contribuinte substituído",
"6405 - CFOP 6405 não registrado no sistema",
"5101 - Venda de produção própria",
"6101 - Venda de produção própria",
"5401 - Venda de produção própria ou de terceiro em operação com produto sujeito ao regime de substituição tributária, na condição de contribuinte substituto",
"6401 - Venda de produção do estabelecimento em operação com produto sujeito ao regime de substituição tributária, na condição de contribuinte substituto",
"5905 - Remessa para depósito fechado ou armazém geral",
"6905 - Remessa para depósito fechado ou armazém geral",
"5923 - Remessa de mercadoria por conta e ordem de terceiros, em venda à ordem",
"6923 - Remessa de mercadoria por conta e ordem de terceiros, em venda à ordem",
"5906 - Retorno de mercadoria depositada em depósito fechado ou armazém geral",
"6906 - Retorno de mercadoria depositada em depósito fechado ou armazém geral",
"5934 - Remessa simbólica de mercadoria depositada em armazém geral ou depósito fechado",
"6934 - Remessa simbólica de mercadoria depositada em armazém geral ou depósito fechado",
"5152 - Transferência de mercadoria adquirida ou recebida de terceiros",
"6152 - Transferência de mercadoria adquirida ou recebida de terceiros",
"5153 - Transferência de energia elétrica",
"6153 - Transferência de energia elétrica",
"5556 - Devolução de compra de material de uso ou consumo",
"6556 - Devolução de compra de material de uso ou consumo",
"5949 - Outra saída de mercadoria ou prestação de serviço não especificado",
"6949 - Outra saída de mercadoria ou prestação de serviço não especificado"
]
}
}
],
"help_text": "Requisitos específicos: CFOPs aceitos: 5102, 6102, 5405, 6405, 5101, 6101, 5401, 6401, 5905, 6905, 5923, 6923, 5906, 6906, 5934, 6934, 5152, 6152, 5153, 6153, 5556, 6556, 5949, 6949"
},
{
"workflow_sequence": 3,
"document_type": "nfe_venda",
"document_type_label": "Nota Fiscal Eletrônica de Venda",
"workflow_status": "completed",
"workflow_status_info": {
"value": "completed",
"label": "Concluído",
"description": "COMPLETED"
},
"document_uploaded": true,
"document_status": "approved",
"can_be_executed_by_customer": true,
"validation_rules": [
{
"cfop": {
"required": true,
"valid_codes": [
"5201",
"6201",
"5202",
"6202",
"5208",
"6208",
"5209",
"6209",
"5410",
"6410",
"5411",
"6411",
"5906",
"6906",
"5907",
"6907",
"5949",
"6949"
],
"description": "Código Fiscal de Operações e Prestações deve ser um dos valores permitidos",
"cfop_details": [
"5201 - Devolução de compra para industrialização ou produção rural",
"6201 - Devolução de compra para industrialização ou produção rural",
"5202 - Devolução de compra para comercialização",
"6202 - Devolução de compra para comercialização",
"5208 - Devolução de mercadoria recebida em transferência para industrialização ou produção rural",
"6208 - Devolução de mercadoria recebida em transferência para industrialização ou produção rural",
"5209 - Devolução de mercadoria recebida em transferência para comercialização",
"6209 - Devolução de mercadoria recebida em transferência para comercialização",
"5410 - Devolução de compra para industrialização ou produção rural em operação com mercadoria sujeita ao regime de substituição tributária",
"6410 - Devolução de compra para industrialização ou produção rural em operação com mercadoria sujeita ao regime de substituição tributária",
"5411 - Devolução de compra para comercialização em operação com mercadoria sujeita ao regime de substituição tributária",
"6411 - Devolução de compra para comercialização em operação com mercadoria sujeita ao regime de substituição tributária",
"5906 - Retorno de mercadoria depositada em depósito fechado ou armazém geral",
"6906 - Retorno de mercadoria depositada em depósito fechado ou armazém geral",
"5907 - Retorno simbólico de mercadoria depositada em depósito fechado ou armazém geral",
"6907 - Retorno simbólico de mercadoria depositada em depósito fechado ou armazém geral",
"5949 - Outra saída de mercadoria ou prestação de serviço não especificado",
"6949 - Outra saída de mercadoria ou prestação de serviço não especificado"
]
}
}
],
"help_text": "Requisitos específicos: CFOPs aceitos: 5201, 6201, 5202, 6202, 5208, 6208, 5209, 6209, 5410, 6410, 5411, 6411, 5906, 6906, 5907, 6907, 5949, 6949"
}
],
"general_tips": [
"Certifique-se de que os XMLs estão válidos e sem erros",
"Verifique se todos os CFOPs estão corretos conforme as regras",
"Confirme que as informações do destinatário estão corretas"
]
}
}
}