Documentação da API para Desenvolvedores

Listagem dos Pedidos de Vendas x Período

Este endpoint retorna a listagem dos pedidos de vendas dentro de um período específico, permitindo filtrar por status e escolher se os produtos devem ser retornados.

1. Endpoint

https://www.prima1.app/api2026V1.php

2. Método HTTP

POST, enviando o corpo da requisição em formato JSON.

3. Autenticação (Token)

A autenticação é feita por meio de um token exclusivo fornecido pelo suporte PrimaSis. O token deve ser enviado no corpo da requisição JSON.

4. Estrutura do Payload (JSON)

{
    "token": "seuTokenAqui",
    "case": "relPv",
    "status": "todos",
    "mostrarProdutos": "S",
    "dtInicial": "2026-07-01",
    "dtFinal": "2026-07-03"
}

4.1 Campos obrigatórios

• token – Token de autenticação.
• case – Deve ser relPv.
• dtInicial – Data inicial (formato YYYY-MM-DD).
• dtFinal – Data final (formato YYYY-MM-DD).

4.2 Campos opcionais

• status – Filtro dos pedidos:
  • abertos
  • fechados
  • concluidos
  • cancelados
  • todos (inclui cancelados)
• mostrarProdutos – "S" para incluir produtos, "N" para ocultar.

5. Exemplo de Requisição (PHP)

<?php

$url = "https://www.prima1.app/api2026V1.php";
$seuToken = "seuTokenAqui";

$payload = [
    "token"           => $seuToken,
    "case"            => "relPv",
    "status"          => "todos",
    "mostrarProdutos" => "S",
    "dtInicial"       => "2026-07-01",
    "dtFinal"         => "2026-07-03"
];

$jsonData = json_encode($payload);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Content-Length: " . strlen($jsonData)
]);

$response = curl_exec($ch);
curl_close($ch);

$resultado = json_decode($response, true);

print_r($resultado);

?>

6. Estrutura da Resposta (JSON)

{
    "status": "OK",
    "case": "relPv",
    "filtroStatus": "todos",
    "registros": 3,
    "dados": [
        {
            "numero": 1234,
            "data": "01/07/2026",
            "cliente": "Cliente Exemplo Ltda",
            "cnpjCliente": "12.345.678/0001-90",
            "situacao": "aberto",
            "status": "todos",
            "valorPedido": "1500.75",
            "produtos": [
                {
                    "descricao": "Produto A",
                    "refprod": "REF001",
                    "qtd": 10,
                    "un": "UN",
                    "valor": "12.5000"
                }
            ]
        }
    ]
}

7. Observações

• Datas devem ser enviadas no formato YYYY-MM-DD.
• O campo status é opcional; padrão = todos.
• O campo mostrarProdutos é opcional; padrão = S.
• Para dúvidas, contate: suporte@primasis.com.