Compras por Parcelas(Carnês)

Para emissão do relatório de compras por parcelas(carnês), é enviado uma requisição do tipo POSTpara o endpoint {{ BASE_REPORT_API_URL }}/v1/relatorio/compras-parcelas passando um objeto FiltroRelatorioDTO no corpo da requisição, com os filtros desejados.

Exemplo de payload
{
  "redeId": 193,
  "empresaId": 388,
  "lojaId": 433,
  "dataInicio": null, // campo opcional para filtrar por data de vencimento da parcela
  "dataFim": null,// campo opcional para filtrar por data de vencimento da parcela
  "dataInicioCompra": null, // campo opcional para filtrar por data de compra
  "dataFimCompra": null, // campo opcional para filtrar por data de compra
  "dataInicioPagamento": null, // campo opcional para filtrar por data de pagamento
  "dataFimPagamento": null, // campo opcional para filtrar por data de pagamento
  "tpGrupos": "null", // verificar endpoints de tipagem
  "tipoRel": "PDF", // verificar endpoints de tipagem
  "totalizarCliente": false // detalhar compras da loja por cliente
  "tpPagamento": "0", // opções válidas relacionadas abaixo:
  // "0" = "Todos", "1" = "Apenas pagos", 
  // "2" = "Apenas em aberto"  
  "tpLanc": "0", // opções válidas relacionadas abaixo:
  // "0" = "Todos", "1" = "Apenas compras", 
  // "2" = "Apenas renegociações"  
}

Essa requisição irá retornar um FILE com o relatório em PDF ou XLS, codificado no formato Base64, de acordo com o tipo de relatório escolhido no objeto FiltroRelatorioDTO.

Para composição desse objeto de filtro, acesse as informações abaixo:

Endpoints e documentação para tipagem dos filtros

Tipos relatórios

É enviado uma requisição do tipo GET para o endpoint abaixo, que irá retornar as opções disponíveis para utilização no campo tipoRel do objeto FiltroRelatorioDTO.

{{ BASE_API_URL }}/v1/tipos/tipos-relatorio
Exemplo de response
[
  {
    "id":"PDF",
    "descricao":"PDF"
  },
  {
    "id":"XLS",
    "descricao":"Excel"
  }
]

Tipos grupos

É enviado uma requisição do tipo GET para o endpoint abaixo, que irá retornar as opções disponíveis para utilização no campo tpGrupos do objeto FiltroRelatorioDTO.

{{ BASE_API_URL }}/v1/tipos/tipos-grupos
Exemplo de response
[
  {
      "id": "A",
      "descricao": "A"
  },
  {
      "id": "B",
      "descricao": "B"
  },
  ...
  {
      "id": "Q",
      "descricao": "Aval Loja"
  },
  {
      "id": "Z",
      "descricao": "Não Informado"
  }
]

Tipos regime por relatório

É enviado uma requisição do tipo GET para o endpoint abaixo, que irá retornar as opções disponíveis para utilização no campo tpPor do objeto FiltroRelatorioDTO.

{{ BASE_API_URL }}/v1/tipos/por-relatorio
Exemplo de response
[
  {
    "id": "CAIXA",
    "descricao": "Caixa"
  },
  {
    "id": "COMPETENCIA",
    "descricao": "Competência"
  }
]

Para mais informações, acesse a documentação da API:


Para mais informações, acesse a documentação da API:


Compras por origemCompras por perfil cliente