curl -X GET "https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222" \
-H "x-api-key: sua-api-key-aqui"
const response = await fetch('https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222', {
method: 'GET',
headers: {
'x-api-key': 'sua-api-key-aqui'
}
});
const result = await response.json();
if (result.success) {
console.log('Venda encontrada:', result.data);
console.log('Itens:', result.data.itens);
} else {
console.error('Erro:', result.error);
}
import requests
url = "https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222"
headers = {
'x-api-key': 'sua-api-key-aqui'
}
response = requests.get(url, headers=headers)
result = response.json()
if response.status_code == 200:
print(f"Venda: {result['data']['pedido']}")
print(f"Cliente: {result['data']['cliente_nome']}")
print(f"Valor Total: R$ {result['data']['valor_total']:.2f}")
print("\nItens:")
for item in result['data']['itens']:
print(f"- {item['produto_id']}: {item['quantidade']} x R$ {item['valor_unitario']:.2f}")
else:
print(f"Erro: {result.get('error', 'Erro desconhecido')}")
{
"success": true,
"data": {
"id": "789e0123-e89b-12d3-a456-426614174222",
"pedido": "PED-2024-003",
"data": "2024-01-25T00:00:00.000Z",
"nf": null,
"status": "Em processamento",
"ano": 2024,
"mes": 1,
"dia": 25,
"cliente_id": "123e4567-e89b-12d3-a456-426614174000",
"cliente_nome": "Supermercado Central",
"representada_id": "987e6543-e89b-12d3-a456-426614174999",
"representada_nome": "Laticínios Exemplo",
"valor_total": 1824.50,
"currency": "BRL",
"itens": [
{
"produto_id": "QUEIJO-MUSSARELA",
"quantidade": 20,
"valor_unitario": 45.90,
"valor_total": 918.00
},
{
"produto_id": "QUEIJO-PRATO",
"quantidade": 15,
"valor_unitario": 42.50,
"valor_total": 637.50
}
],
"created_at": "2024-01-25T14:30:00Z",
"updated_at": "2024-01-25T14:30:00Z"
}
}
{
"error": "Venda não encontrada"
}
{
"error": "API key inválida"
}
Vendas
Buscar Venda
Busca uma venda específica pelo ID
GET
/
api
/
v1
/
sales
/
{id}
curl -X GET "https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222" \
-H "x-api-key: sua-api-key-aqui"
const response = await fetch('https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222', {
method: 'GET',
headers: {
'x-api-key': 'sua-api-key-aqui'
}
});
const result = await response.json();
if (result.success) {
console.log('Venda encontrada:', result.data);
console.log('Itens:', result.data.itens);
} else {
console.error('Erro:', result.error);
}
import requests
url = "https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222"
headers = {
'x-api-key': 'sua-api-key-aqui'
}
response = requests.get(url, headers=headers)
result = response.json()
if response.status_code == 200:
print(f"Venda: {result['data']['pedido']}")
print(f"Cliente: {result['data']['cliente_nome']}")
print(f"Valor Total: R$ {result['data']['valor_total']:.2f}")
print("\nItens:")
for item in result['data']['itens']:
print(f"- {item['produto_id']}: {item['quantidade']} x R$ {item['valor_unitario']:.2f}")
else:
print(f"Erro: {result.get('error', 'Erro desconhecido')}")
{
"success": true,
"data": {
"id": "789e0123-e89b-12d3-a456-426614174222",
"pedido": "PED-2024-003",
"data": "2024-01-25T00:00:00.000Z",
"nf": null,
"status": "Em processamento",
"ano": 2024,
"mes": 1,
"dia": 25,
"cliente_id": "123e4567-e89b-12d3-a456-426614174000",
"cliente_nome": "Supermercado Central",
"representada_id": "987e6543-e89b-12d3-a456-426614174999",
"representada_nome": "Laticínios Exemplo",
"valor_total": 1824.50,
"currency": "BRL",
"itens": [
{
"produto_id": "QUEIJO-MUSSARELA",
"quantidade": 20,
"valor_unitario": 45.90,
"valor_total": 918.00
},
{
"produto_id": "QUEIJO-PRATO",
"quantidade": 15,
"valor_unitario": 42.50,
"valor_total": 637.50
}
],
"created_at": "2024-01-25T14:30:00Z",
"updated_at": "2024-01-25T14:30:00Z"
}
}
{
"error": "Venda não encontrada"
}
{
"error": "API key inválida"
}
Retorna todos os detalhes de uma venda, incluindo informações do cliente, representada e todos os itens.
Você precisa de uma API key válida no header x-api-key para usar este endpoint.
Path Parameters
string
required
ID único da venda (UUID)
Headers
string
required
API key de autenticação
curl -X GET "https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222" \
-H "x-api-key: sua-api-key-aqui"
const response = await fetch('https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222', {
method: 'GET',
headers: {
'x-api-key': 'sua-api-key-aqui'
}
});
const result = await response.json();
if (result.success) {
console.log('Venda encontrada:', result.data);
console.log('Itens:', result.data.itens);
} else {
console.error('Erro:', result.error);
}
import requests
url = "https://api.sistema-representantes.com.br/api/v1/sales/789e0123-e89b-12d3-a456-426614174222"
headers = {
'x-api-key': 'sua-api-key-aqui'
}
response = requests.get(url, headers=headers)
result = response.json()
if response.status_code == 200:
print(f"Venda: {result['data']['pedido']}")
print(f"Cliente: {result['data']['cliente_nome']}")
print(f"Valor Total: R$ {result['data']['valor_total']:.2f}")
print("\nItens:")
for item in result['data']['itens']:
print(f"- {item['produto_id']}: {item['quantidade']} x R$ {item['valor_unitario']:.2f}")
else:
print(f"Erro: {result.get('error', 'Erro desconhecido')}")
Response
Sucesso
boolean
Indica se a operação foi bem-sucedida
object
Dados completos da venda
Show Estrutura da venda
Show Estrutura da venda
string
ID único da venda (UUID)
string
Código do pedido
string
Data da venda
string
Número da nota fiscal (opcional)
string
Status da venda
string
ID do cliente
string
Nome do cliente
string
ID da representada
string
Nome da representada
number
Valor total da venda
array
string
Data de criação
string
Data da última atualização
{
"success": true,
"data": {
"id": "789e0123-e89b-12d3-a456-426614174222",
"pedido": "PED-2024-003",
"data": "2024-01-25T00:00:00.000Z",
"nf": null,
"status": "Em processamento",
"ano": 2024,
"mes": 1,
"dia": 25,
"cliente_id": "123e4567-e89b-12d3-a456-426614174000",
"cliente_nome": "Supermercado Central",
"representada_id": "987e6543-e89b-12d3-a456-426614174999",
"representada_nome": "Laticínios Exemplo",
"valor_total": 1824.50,
"currency": "BRL",
"itens": [
{
"produto_id": "QUEIJO-MUSSARELA",
"quantidade": 20,
"valor_unitario": 45.90,
"valor_total": 918.00
},
{
"produto_id": "QUEIJO-PRATO",
"quantidade": 15,
"valor_unitario": 42.50,
"valor_total": 637.50
}
],
"created_at": "2024-01-25T14:30:00Z",
"updated_at": "2024-01-25T14:30:00Z"
}
}
{
"error": "Venda não encontrada"
}
{
"error": "API key inválida"
}