API Reference

Buscar Venda do PDV

Para buscar uma venda do PDV utilize o GET abaixo:

GET END_POINT/venda/empresa/:ID_EMPRESA/listar?data-inicio=2023-11-01&data-fim=2023-11-01&pago=false&first=0&limit=9&ordem=DESC

📘

Informação: Se pago estiver false serão buscadas somente as vendas que não foram pagas. Se estiver true buscará todas vendas pagas.

{
  "first" : 0,
  "limit" : 9,
  "count" : 2,
  "data" : [ {
    "id" : 1052392,
    "empresa" : {
      "id" : "b51ae983-184f-4d31-9f28-92db414557f9",
      "tipo" : "PESSOA_JURIDICA",
      "cnpj" : "35883567000138",
      "razao_social" : "PEDRO PCS LTDA",
      "nome_fantasia" : "PEDRO PCS",
      "inscricao_municipal" : "000",
      "inscricao_estadual" : "",
      "telefone" : "1142219170",
      "email" : "[email protected]",
      "primeiroNome" : "PEDRO",
      "documento" : "35883567000138",
      "ultimoNome" : " PCS LTDA"
    },
    "cliente" : {
      "id" : "61756d1c-3de8-40f0-b73a-8f13f76276a7",
      "tipo" : "PESSOA_FISICA",
      "nome" : "Lucas da Cunha",
      "cpf" : "72821400063",
      "email" : "[email protected]",
      "telefone_celular" : "11940092000",
      "cep" : "09720-470",
      "endereco" : "Rua Comendador Carlo Mário Gardano",
      "complemento" : "",
      "numero" : "103",
      "bairro" : "Centro",
      "cidade" : "São Bernardo do Campo",
      "uf" : "SP",
      "codigo_ibge" : "3548708",
      "data_atualizacao" : "2025-04-01T15:07:12",
      "status" : "ATIVO",
      "empresa_id" : "b51ae983-184f-4d31-9f28-92db414557f9",
      "observacoes" : "",
      "pep" : false,
      "primeiroNome" : "Lucas",
      "documento" : "72821400063",
      "ultimoNome" : " da Cunha"
    },
    "operador_criacao" : {
      "id" : "53eecb76-c9fc-4195-b612-9463cbac72dd",
      "nome" : "Lucas Gabriel Silva Pires",
      "admin" : false
    },
    "operador_atualizacao" : {
      "id" : "53eecb76-c9fc-4195-b612-9463cbac72dd",
      "nome" : "Lucas Gabriel Silva Pires",
      "admin" : false
    },
    "pagamentos" : [ ],
    "notasfiscais" : [ ],
    "ingressos" : [ ],
    "itens" : [ {
      "quantidade" : 1,
      "servico" : {
        "id" : "e765d266-338b-4fef-b622-3899d17039c3",
        "sku" : "12345622ss22",
        "status" : "ATIVO",
        "empresa_id" : "b51ae983-184f-4d31-9f28-92db414557f9",
        "nome" : "Anestesia",
        "descricao" : "",
        "valor" : 100.00,
        "iss_retido" : false,
        "perc_base_calculo_iss" : 0.00,
        "aliquota_iss" : 0.00,
        "inss_retido" : false,
        "aliquota_inss" : 0.00,
        "perc_base_calculo_inss" : 0.00,
        "pis_retido" : false,
        "aliquota_pis" : 0.00,
        "cofins_retido" : false,
        "aliquota_cofins" : 0.00,
        "ir_retido" : false,
        "aliquota_ir" : 0.00,
        "csll_retido" : false,
        "aliquota_csll" : 0.00,
        "splits" : [ {
          "recebedor" : {
            "id" : "b51ae983-184f-4d31-9f28-92db414557f9",
            "tipo" : "PESSOA_JURIDICA",
            "cnpj" : "35883567000138",
            "razao_social" : "PEDRO PCS LTDA",
            "nome_fantasia" : "PEDRO PCS",
            "primeiroNome" : "PEDRO",
            "documento" : "35883567000138",
            "ultimoNome" : " PCS LTDA"
          },
          "metodo" : "PERCENTUAL",
          "valor" : 60.00,
          "paga_taxa_transacao" : true,
          "paga_resto_divisao_taxa" : true
        }, {
          "recebedor" : {
            "id" : "7f3a736f-19f3-4087-8344-2bddadff7fbd",
            "tipo" : "PESSOA_JURIDICA",
            "cnpj" : "87232317000131",
            "razao_social" : "ZIP CONTABILIDADE",
            "nome_fantasia" : "ZIP CONTABILIDADE SANDBOX",
            "primeiroNome" : "ZIP",
            "documento" : "87232317000131",
            "ultimoNome" : " CONTABILIDADE"
          },
          "metodo" : "PERCENTUAL",
          "valor" : 40.00,
          "paga_taxa_transacao" : false,
          "paga_resto_divisao_taxa" : false
        } ],
        "data_criacao" : "2024-06-20T11:25:54",
        "data_atualizacao" : "2025-06-09T15:37:14"
      },
      "desconto" : 0.00,
      "valor" : 100.00,
      "executado" : false,
      "total" : 100.00,
      "valorLiquido" : 100.00
    } ],
    "descontos" : 0.00,
    "adicional_prestador" : 0.00,
    "taxa_entrega" : 0.00,
    "pago" : false,
    "splits" : [ {
      "recebedor" : {
        "id" : "b51ae983-184f-4d31-9f28-92db414557f9",
        "tipo" : "PESSOA_JURIDICA",
        "cnpj" : "35883567000138",
        "razao_social" : "PEDRO PCS LTDA",
        "nome_fantasia" : "PEDRO PCS",
        "primeiroNome" : "PEDRO",
        "documento" : "35883567000138",
        "ultimoNome" : " PCS LTDA"
      },
      "metodo" : "PERCENTUAL",
      "valor" : 60.00,
      "paga_taxa_transacao" : true,
      "paga_resto_divisao_taxa" : true
    }, {
      "recebedor" : {
        "id" : "7f3a736f-19f3-4087-8344-2bddadff7fbd",
        "tipo" : "PESSOA_JURIDICA",
        "cnpj" : "87232317000131",
        "razao_social" : "ZIP CONTABILIDADE",
        "nome_fantasia" : "ZIP CONTABILIDADE SANDBOX",
        "primeiroNome" : "ZIP",
        "documento" : "87232317000131",
        "ultimoNome" : " CONTABILIDADE"
      },
      "metodo" : "PERCENTUAL",
      "valor" : 40.00,
      "paga_taxa_transacao" : false,
      "paga_resto_divisao_taxa" : false
    } ],
    "data_criacao" : "2025-07-07T13:09:46",
    "data_atualizacao" : "2025-07-07T13:09:46",
    "totalItens" : 100.00,
    "subTotal" : 100.00,
    "totalPagar" : 100.00,
    "totalPagoTaxa" : 0,
    "totalPagoMdr" : 0,
    "totalPagoBruto" : 0,
    "totalDescontoPagamento" : 0,
    "totalPagoLiquido" : 0,
    "totalPagoServico" : 0,
    "totalPagoProduto" : 0,
    "total" : 100.00,
    "valorTotalServico" : 100.00,
    "valorTotalProduto" : 0
  }, {
    "id" : 1052391,
    "empresa" : {
      "id" : "b51ae983-184f-4d31-9f28-92db414557f9",
      "tipo" : "PESSOA_JURIDICA",
      "cnpj" : "35883567000138",
      "razao_social" : "PEDRO PCS LTDA",
      "nome_fantasia" : "PEDRO PCS",
      "inscricao_municipal" : "000",
      "inscricao_estadual" : "",
      "telefone" : "1142219170",
      "email" : "[email protected]",
      "primeiroNome" : "PEDRO",
      "documento" : "35883567000138",
      "ultimoNome" : " PCS LTDA"
    },
    "cliente" : {
      "id" : "61756d1c-3de8-40f0-b73a-8f13f76276a7",
      "tipo" : "PESSOA_FISICA",
      "nome" : "Lucas da Cunha",
      "cpf" : "72821400063",
      "email" : "[email protected]",
      "telefone_celular" : "11940092000",
      "cep" : "09720-470",
      "endereco" : "Rua Comendador Carlo Mário Gardano",
      "complemento" : "",
      "numero" : "103",
      "bairro" : "Centro",
      "cidade" : "São Bernardo do Campo",
      "uf" : "SP",
      "codigo_ibge" : "3548708",
      "data_atualizacao" : "2025-04-01T15:07:12",
      "status" : "ATIVO",
      "empresa_id" : "b51ae983-184f-4d31-9f28-92db414557f9",
      "observacoes" : "",
      "pep" : false,
      "primeiroNome" : "Lucas",
      "documento" : "72821400063",
      "ultimoNome" : " da Cunha"
    },
    "operador_criacao" : {
      "id" : "53eecb76-c9fc-4195-b612-9463cbac72dd",
      "nome" : "Lucas Gabriel Silva Pires",
      "admin" : false
    },
    "operador_atualizacao" : {
      "id" : "53eecb76-c9fc-4195-b612-9463cbac72dd",
      "nome" : "Lucas Gabriel Silva Pires",
      "admin" : false
    },
    "pagamentos" : [ ],
    "notasfiscais" : [ ],
    "ingressos" : [ ],
    "itens" : [ {
      "quantidade" : 1,
      "servico" : {
        "id" : "e765d266-338b-4fef-b622-3899d17039c3",
        "sku" : "12345622ss22",
        "status" : "ATIVO",
        "empresa_id" : "b51ae983-184f-4d31-9f28-92db414557f9",
        "nome" : "Anestesia",
        "descricao" : "",
        "valor" : 100.00,
        "iss_retido" : false,
        "perc_base_calculo_iss" : 0.00,
        "aliquota_iss" : 0.00,
        "inss_retido" : false,
        "aliquota_inss" : 0.00,
        "perc_base_calculo_inss" : 0.00,
        "pis_retido" : false,
        "aliquota_pis" : 0.00,
        "cofins_retido" : false,
        "aliquota_cofins" : 0.00,
        "ir_retido" : false,
        "aliquota_ir" : 0.00,
        "csll_retido" : false,
        "aliquota_csll" : 0.00,
        "splits" : [ {
          "recebedor" : {
            "id" : "b51ae983-184f-4d31-9f28-92db414557f9",
            "tipo" : "PESSOA_JURIDICA",
            "cnpj" : "35883567000138",
            "razao_social" : "PEDRO PCS LTDA",
            "nome_fantasia" : "PEDRO PCS",
            "primeiroNome" : "PEDRO",
            "documento" : "35883567000138",
            "ultimoNome" : " PCS LTDA"
          },
          "metodo" : "PERCENTUAL",
          "valor" : 60.00,
          "paga_taxa_transacao" : true,
          "paga_resto_divisao_taxa" : true
        }, {
          "recebedor" : {
            "id" : "7f3a736f-19f3-4087-8344-2bddadff7fbd",
            "tipo" : "PESSOA_JURIDICA",
            "cnpj" : "87232317000131",
            "razao_social" : "ZIP CONTABILIDADE",
            "nome_fantasia" : "ZIP CONTABILIDADE SANDBOX",
            "primeiroNome" : "ZIP",
            "documento" : "87232317000131",
            "ultimoNome" : " CONTABILIDADE"
          },
          "metodo" : "PERCENTUAL",
          "valor" : 40.00,
          "paga_taxa_transacao" : false,
          "paga_resto_divisao_taxa" : false
        } ],
        "data_criacao" : "2024-06-20T11:25:54",
        "data_atualizacao" : "2025-06-09T15:37:14"
      },
      "desconto" : 0.00,
      "valor" : 100.00,
      "executado" : false,
      "total" : 100.00,
      "valorLiquido" : 100.00
    } ],
    "descontos" : 0.00,
    "adicional_prestador" : 0.00,
    "taxa_entrega" : 0.00,
    "pago" : false,
    "splits" : [ {
      "recebedor" : {
        "id" : "b51ae983-184f-4d31-9f28-92db414557f9",
        "tipo" : "PESSOA_JURIDICA",
        "cnpj" : "35883567000138",
        "razao_social" : "PEDRO PCS LTDA",
        "nome_fantasia" : "PEDRO PCS",
        "primeiroNome" : "PEDRO",
        "documento" : "35883567000138",
        "ultimoNome" : " PCS LTDA"
      },
      "metodo" : "PERCENTUAL",
      "valor" : 60.00,
      "paga_taxa_transacao" : true,
      "paga_resto_divisao_taxa" : true
    }, {
      "recebedor" : {
        "id" : "7f3a736f-19f3-4087-8344-2bddadff7fbd",
        "tipo" : "PESSOA_JURIDICA",
        "cnpj" : "87232317000131",
        "razao_social" : "ZIP CONTABILIDADE",
        "nome_fantasia" : "ZIP CONTABILIDADE SANDBOX",
        "primeiroNome" : "ZIP",
        "documento" : "87232317000131",
        "ultimoNome" : " CONTABILIDADE"
      },
      "metodo" : "PERCENTUAL",
      "valor" : 40.00,
      "paga_taxa_transacao" : false,
      "paga_resto_divisao_taxa" : false
    } ],
    "data_criacao" : "2025-07-07T13:05:35",
    "data_atualizacao" : "2025-07-07T13:05:35",
    "totalItens" : 100.00,
    "subTotal" : 100.00,
    "totalPagar" : 100.00,
    "totalPagoTaxa" : 0,
    "totalPagoMdr" : 0,
    "totalPagoBruto" : 0,
    "totalDescontoPagamento" : 0,
    "totalPagoLiquido" : 0,
    "totalPagoServico" : 0,
    "totalPagoProduto" : 0,
    "total" : 100.00,
    "valorTotalServico" : 100.00,
    "valorTotalProduto" : 0
  } ],
  "size" : 2
}

Lembrando que para buscar vendas PENDENTES pode colocar da seguinte forma:
END_POINT/venda/empresa/:id_empresa/listar?data-inicio=2025-07-07&data-fim=2025-07-07&cancelada=false&first=0&limit=9&ordem=DESC&pago=false

Vendas canceladas:
END_POINT/venda/empresa/:id_empresa/listar?data-inicio=2025-07-07&data-fim=2025-07-07&cancelada=true&first=0&limit=9&ordem=DESC

Vendas pagas:
END_POINT/venda/empresa/:id_empresa/listar?data-inicio=2025-07-07&data-fim=2025-07-07&cancelada=false&first=0&limit=9&ordem=DESC&pago=true

Language
Credentials
Basic
base64
:
Click Try It! to start a request and see the response here!