# Listar processos

Retorna uma lista paginada de processos conforme filtros informados.  os filtros também podem ser enviados no corpo (JSON), conforme exemplo de curl, caso seu cliente HTTP suporte body em requisições GET.

Endpoint: GET /v3/pvt/processo
Version: 1.0.0
Security: BearerAuth

## Query parameters:

  - `pageNumber` (integer)
    Número da página (inicia em 1).

  - `pageSize` (integer)
    Quantidade de itens por página.

  - `de` (string)
    Data inicial (YYYY-MM-DD).

  - `ate` (string)
    Data final (YYYY-MM-DD).

  - `status` (integer)
    Status do processo (Todos = -1, Pendente = 1, Concluido = 2, Cancelado = 3).

  - `textoBusca` (string)
    Número do pedido, nome/email do cliente ou nº de autorização.

  - `lojaVirtualId` (integer)
    Id da loja virtual (sub account).

  - `orderNumber` (string)
    Número do pedido original na loja virtual.

  - `estagioLogistico` (integer)
    Estágio logístico do processo (EProcessLogisticStage).

  - `estagioFinanceiro` (integer)
    Estágio financeiro do processo (EProcessFinancialStage).

  - `estagioRating` (integer)
    Estágio rating do processo (EProcessRatingStage).

## Request fields (application/json):

  - `de` (string)
    Data inicial (YYYY-MM-DD).

  - `ate` (string)
    Data final (YYYY-MM-DD).

  - `status` (integer)
    Status do processo (Todos = -1, Pendente = 1, Concluido = 2, Cancelado = 3).

  - `textoBusca` (string)
    Número do pedido (e-commerce), nome/email do cliente ou nº de autorização.

  - `lojaVirtualId` (integer)
    Id da loja virtual (sub account).

  - `orderNumber` (string)
    Número do pedido original na loja virtual.

  - `estagioLogistico` (integer)
    Estágio logístico do processo.
    Enum: 0, 1, 2, 3, 4, 5, 6, 7

  - `estagioFinanceiro` (integer)
    Estágio financeiro do processo.
    Enum: 0, 1, 2, 3, 4

  - `estagioRating` (integer)
    Estágio de rating do processo.
    Enum: 0, 1, 2

## Response 200 fields (application/json):

  - `PageSize` (integer)

  - `TotalPages` (integer)

  - `CurrentPage` (integer)

  - `TotalRecords` (integer)

  - `Date` (string, required)
    Data e hora da resposta expressa em UTC

  - `Result` (array, required)
    Entidade relacionada

  - `Result.id` (integer)

  - `Result.tipo` (integer)
    Tipo de Processo: Devolucao = 0, Troca = 1
    Enum: 0, 1

  - `Result.tipoFreteEstorno` (integer)
    Tipo de estorno do frete (EPedidoItemEstorno): 0 ValeCompras, 1 Estorno, 2 Estorno automático
    Enum: 0, 1, 2

  - `Result.valorDiferenca` (number)
    0: não há diferença; >0: valor a receber do usuário; <0: valor a pagar ao usuário

  - `Result.mantenhaOItem` (boolean,null)
    True quando a solicitação faz jus à funcionalidade KeepTheItem; do contrário, False

  - `Result.status` (integer)
    Indefinido = -1, Iniciado = 0, Pendente = 1, Concluido = 2, Cancelado = 3
    Enum: -1, 0, 1, 2, 3

  - `Result.numero` (string)
    Número da solicitação

  - `Result.data` (string)
    Data da solicitação

  - `Result.dadosBancariosDto` (object)
    Dados bancários do cliente para reembolso quando não for cartão de crédito

  - `Result.dadosBancariosDto.id` (integer)
    Identificador do DTO

  - `Result.dadosBancariosDto.nomeTitular` (string,null)
    Nome do titular

  - `Result.dadosBancariosDto.cpfTitular` (string,null)
    CPF do titular

  - `Result.dadosBancariosDto.tipo` (integer)
    0 ContaBancaria, 1 PIX, 2 Automático, 3 Estorno Manual

  - `Result.dadosBancariosDto.tipoChavePix` (integer)
    0 Aleatória, 1 CPF_CNPJ, 2 Celular, 3 Email

  - `Result.dadosBancariosDto.tipoChavePixDesc` (string)
    Descrição da chave Pix fornecida

  - `Result.dadosBancariosDto.tipoReembolsoDesc` (string)
    Descrição do tipo de reembolso

  - `Result.dadosBancariosDto.chavePix` (string,null)
    Chave Pix

  - `Result.dadosBancariosDto.banco` (string,null)
    Nome do banco

  - `Result.dadosBancariosDto.agencia` (string,null)
    Agência

  - `Result.dadosBancariosDto.contaCorrente` (string,null)
    Conta corrente

  - `Result.dadosBancariosDto.tipoContaBancaria` (string,null)
    Tipo de conta (corrente/poupança)

  - `Result.dadosBancariosDto.pagamentoRealizado` (boolean)
    True se o estorno foi realizado

  - `Result.dadosBancariosDto.DataGeracao` (string,null)
    Data de geração

  - `Result.dadosBancariosDto.valorEstorno` (number,null)
    Valor estornado

  - `Result.dadosBancariosDto.valorManualEstorno` (number,null)
    Valor manual estornado

  - `Result.notaFiscalDevolucao` (object,null)
    Nota fiscal de devolução

  - `Result.pedido` (object)

  - `Result.pedido.numero` (string)
    Número do pedido

  - `Result.pedido.pedidoId` (string)
    Id do pedido no ecommerce

  - `Result.pedido.data` (string)
    Data/hora do pedido

  - `Result.pedido.dataEntrega` (string,null)
    Data em que os pacotes foram entregues

  - `Result.pedido.valor` (number)
    Valor do pedido

  - `Result.pedido.valorFrete` (number)
    Valor do frete

  - `Result.pedido.valorDesconto` (number)
    Valor de desconto

  - `Result.pedido.clienteNome` (string)
    Nome do cliente

  - `Result.pedido.clienteEmail` (string)
    Email do cliente

  - `Result.pedido.clienteTelefone` (string)
    Telefone do cliente

  - `Result.pedido.clienteCelular` (string)
    Celular do cliente

  - `Result.pedido.parcelas` (integer)
    Número de parcelas

  - `Result.pedido.status` (string,null)
    Status do pedido

  - `Result.pedido.clienteEndereco` (object)
    Representa um endereço físico

  - `Result.pedido.clienteEndereco.logradouro` (string)
    Logradouro

  - `Result.pedido.clienteEndereco.numero` (string)
    Número

  - `Result.pedido.clienteEndereco.complemento` (string)
    Complemento

  - `Result.pedido.clienteEndereco.bairro` (string)
    Bairro

  - `Result.pedido.clienteEndereco.cidade` (string)
    Cidade

  - `Result.pedido.clienteEndereco.estado` (string)
    Estado

  - `Result.pedido.clienteEndereco.cep` (string)
    CEP

  - `Result.pedido.clienteEndereco.latitude` (string,null)
    Latitude

  - `Result.pedido.clienteEndereco.longitude` (string,null)
    Longitude

  - `Result.pedido.clienteEndereco.obs` (string,null)
    Observações gerais

  - `Result.pedido.skus` (array)
    Itens do pedido

  - `Result.pedido.skus.skuId` (string)
    Id do SKU na loja virtual

  - `Result.pedido.skus.skuNome` (string)
    Nome do SKU

  - `Result.pedido.skus.skuRef` (string)
    Referência do SKU

  - `Result.pedido.skus.skuSellerReference` (string)
    Referência do SKU no seller

  - `Result.pedido.skus.produtoId` (string)
    Id do produto no ecommerce

  - `Result.pedido.skus.produtoNome` (string)
    Nome do produto

  - `Result.pedido.skus.productRef` (string)

  - `Result.pedido.skus.preco` (number)
    Preço do SKU praticado no pedido

  - `Result.pedido.skus.quantidade` (integer)
    Quantidade do SKU na solicitação

  - `Result.pedido.skus.quantidadeTotal` (integer)
    Quantidade do SKU no pedido

  - `Result.pedido.skus.imagemUrl` (string)
    URL da imagem do SKU

  - `Result.pedido.skus.sellerId` (string)
    Id do vendedor (marketplace)

  - `Result.pedido.skus.docaId` (string)
    Id da doca

  - `Result.pedido.skus.estoqueId` (string)
    Id do estoque

  - `Result.pedido.skus.tipoProcesso` (integer)
    0=Devolução, 1=Troca
    Enum: 0, 1

  - `Result.pedido.skus.tipoDescricao` (string)
    Descrição derivada de tipoProcesso

  - `Result.pedido.skus.motivo` (object)

  - `Result.pedido.skus.motivo.descricao` (string)
    Descrição do motivo

  - `Result.pedido.skus.peso` (number)
    Peso (g)

  - `Result.pedido.skus.altura` (number)
    Altura (cm)

  - `Result.pedido.skus.largura` (number)
    Largura (cm)

  - `Result.pedido.skus.comprimento` (number)
    Comprimento (cm)

  - `Result.pedido.skus.ratingDate` (string,null)
    Data do rating

  - `Result.pedido.skus.estadoDoItem` (integer)
    Estado do item: 0 Indefinido, 1 PerfeitoEstado, 2 PequenaAvaria, 3 NaoPodeSerAProveitado, 4 NaoRecebido
    Enum: 0, 1, 2, 3, 4

  - `Result.pedido.skus.skusParaTroca` (array)
    SKUs para troca, quando houver

  - `Result.pedido.skus.packageDescription` (string,null)
    Descrição do pacote (ex.: VTEX packages.description)

  - `Result.pedido.skus.invoiceKey` (string,null)
    Chave da NF vinculada ao item

  - `Result.pedido.transacoes` (array)
    Transações de pagamento do pedido

  - `Result.pedido.transacoes.tid` (string)
    Id da transação (Se vtex, obter o valor de transactions[].transactionId)

  - `Result.pedido.transacoes.ativa` (boolean)
    Transação ativa?

  - `Result.pedido.transacoes.sellerNomeId` (string)
    Nome identificador do seller (Se vtex, obter o valor de transactions[].merchantName)

  - `Result.pedido.transacoes.pagamentos` (array)
    Coleção de pagamentos da transação

  - `Result.pedido.transacoes.pagamentos.pId` (string,null)
    Id do pagamento (Se vtex, obter o valor de transactions[].payments[].id)

  - `Result.pedido.transacoes.pagamentos.tipoPagamentoId` (string)
    Id do tipo de pagamento (Se vtex, obter o valor de transactions[].payments[].paymentSystem)

  - `Result.pedido.transacoes.pagamentos.tipoPagamentoDescricao` (string)
    Descrição do tipo de pagamento (Se vtex, obter o valor de transactions[].payments[].paymentSystemName)

  - `Result.pedido.transacoes.pagamentos.valor` (number)
    Valor do pagamento

  - `Result.pedido.transacoes.pagamentos.parcelamento` (integer)
    Número de parcelas

  - `Result.pedido.transacoes.pagamentos.valorReferencia` (number)
    Valor de referência

  - `Result.pedido.transacoes.pagamentos.valeCompraUtilizadoId` (string,null)
    Se usado, id do vale-compra

  - `Result.pedido.transacoes.pagamentos.valeCompraUtilizadoNome` (string,null)
    Se usado, nome do vale-compra

  - `Result.pedido.transacoes.pagamentos.giftCardProvider` (string,null)
    Meio de vale/ gift-card (ex.: GiftcardLivelo)

  - `Result.pedido.transacoes.pagamentos.tid` (string,null)
    TID do adquirente (Se vtex, obter o valor de transactions[].payments[].connectorResponses.id)

  - `Result.pedido.transacoes.pagamentos.nsu` (string,null)
    NSU do adquirente (Se vtex, obter o valor de transactions[].payments[].connectorResponses.nsu)

  - `Result.pedido.transacoes.pagamentos.adquirente` (string,null)
    Adquirente (Se vtex, obter o valor de transactions[].payments[].connectorResponses.acquirer)

  - `Result.pedido.transacoes.pagamentos.grupo` (string)
    Grupo do meio de pagamento (Se vtex, obter o valor de transactions[].payments[].group - ex.: instantPayment | creditCard | giftCard | cashback)

  - `Result.pedido.transacoes.pagamentos.descricao` (string)
    Descrição calculada do pagamento

  - `Result.pedido.transacoes.data` (string,null)
    Data do registro da transação

  - `Result.pedido.transacoes.verificado` (boolean,null)
    Transação verificada em um estorno

  - `Result.pedido.transacoes.acaoManualRequerida` (boolean)
    True se o estorno automático falhou e exige ação manual

  - `Result.pedido.notaNumero` (string,null)
    Número da nota fiscal

  - `Result.pedido.notaValor` (number,null)
    Valor da nota fiscal

  - `Result.pedido.notaChave` (string,null)
    Chave da nota fiscal

  - `Result.pedido.notaSerie` (string,null)
    Série da nota fiscal

  - `Result.pedido.notaData` (string,null)
    Data da nota fiscal

  - `Result.lojaVirtual` (object)
    Loja virtual configurada na plataforma Genius

  - `Result.lojaVirtual.lojaUrl` (string)
    URL da loja virtual

  - `Result.lojaVirtual.ativo` (boolean)
    Loja ativa quando True; do contrário, False

  - `Result.valeCompra` (object)
    Informações do vale-compra quando a forma de reembolso for vale

  - `Result.valeCompra.instanciaId` (integer,null)

  - `Result.valeCompra.definicaoId` (integer,null)

  - `Result.valeCompra.valor` (number)
    Valor em R$ atribuído quando já utilizado

  - `Result.valeCompra.valorManual` (number,null)
    Valor manual

  - `Result.valeCompra.valorPorcentagem` (number)
    Percentual do vale-compra

  - `Result.valeCompra.data` (string,null)
    Data em que a instância foi gerada

  - `Result.valeCompra.expirarEm` (string,null)
    Data de expiração do vale

  - `Result.valeCompra.redemptionToken` (string,null)
    Token de resgate

  - `Result.valeCompra.gerado` (boolean)
    True se o vale compra foi gerado. Do contrário, false

  - `Result.valeCompra.DataGeracao` (string,null)
    Data de geração do vale

  - `Result.autorizacoesLR` (array)
    Coleção de autorizações de logística reversa

  - `Result.autorizacoesLR.data` (string)
    Data da autorização

  - `Result.autorizacoesLR.descricao` (string)
    Descrição da postagem

  - `Result.autorizacoesLR.codigoAutorizacao` (string)
    Código de autorização de postagem

  - `Result.autorizacoesLR.codigoLogisticoIdentificador` (string)
    Código que identifica o objeto já postado

  - `Result.autorizacoesLR.prazoParaPostagem` (string,null)
    Prazo limite para postagem

  - `Result.autorizacoesLR.dataPostagemOuColeta` (string,null)
    Data da postagem ou coleta

  - `Result.autorizacoesLR.dataRecebimentoCD` (string,null)
    Data de recebimento no CD

  - `Result.autorizacoesLR.tipoDescricao` (string)
    Descrição do tipo de postagem

  - `Result.autorizacoesLR.tipo` (integer)
    Tipo de postagem: -1 Indefinido, 0 PostagemEmAgencia, 1 ColetaSimples, 2 ColetaSwap, 3 Expressa, 4 PostoDeColeta
    Enum: -1, 0, 1, 2, 3, 4

  - `Result.autorizacoesLR.custo` (number,null)
    Valor efetivo da postagem/coleta

  - `Result.autorizacoesLR.destino` (object)
    Representa um endereço físico

  - `Result.autorizacoesLR.erroCodigo` (string,null)
    Código de erro

  - `Result.autorizacoesLR.erroDescricao` (string,null)
    Descrição do erro

  - `Result.autorizacoesLR.hubOrderId` (string,null)
    Id do pedido no hub logístico

  - `Result.autorizacoesLR.transportadora` (object)
    Dados da transportadora quando a forma de envio for transportadora

  - `Result.autorizacoesLR.transportadora.nome` (string)
    Nome da transportadora

  - `Result.lojaFisica` (object)
    Dados da loja física quando a devolução ocorre em loja

  - `Result.lojaFisica.descricao` (string)
    Descrição/Nome da loja física

  - `Result.tipoServicoLogistico` (integer)
    Tipo de remessa reversa (EDTipoEntregaReversa): -1 Indefinido, 0 PostagemEmAgencia, 1 ColetaSimples, 2 ColetaSimultanea, 3 Expressa, 4 PostoDeColeta
    Enum: -1, 0, 1, 2, 3, 4

  - `Result.tipoServicoLogisticoDescricao` (string)
    Descrição do tipo de logística reversa

  - `Result.locker` (object)
    Dados do locker quando a postagem é em armário inteligente

  - `Result.locker.transportadoraId` (integer)
    Id da transportadora dona do posto

  - `Result.locker.nome` (string)
    Nome do locker

  - `Result.locker.instrucoesPostagem` (string)
    Instruções de postagem

  - `Result.locker.instrucoesRecebimento` (string)
    Instruções de recebimento

  - `Result.locker.instrucoesAdicionais` (string)
    Instruções adicionais

  - `Result.locker.endereco` (object)
    Representa um endereço físico

  - `Result.locker.imagens` (array)

  - `Result.locker.horariosFuncionamento` (array)

  - `Result.locker.qrCodes` (array)

  - `Result.locker.tiposCompartimento` (array)

  - `Result.valorLogisticaPremium` (number,null)
    Quando logística premium fornecida, valor a ser pago

  - `Result.agente` (object)

  - `Result.agente.nome` (string)
    Nome do agente (SAC)

  - `Result.marketplace` (boolean)
    True se marketplace

  - `Result.blocklist` (boolean)
    True se em Blocklist

  - `Result.cashback` (object)
    Dados de cashback, quando cabível

  - `Result.cashback.valor` (number)
    Valor do cashback

  - `Result.cashback.DataGeracao` (string,null)
    Data de efetivação do cashback

  - `Result.cashback.gerado` (boolean)
    True se gerado

  - `Result.progress` (object)
    Estágios do processo

  - `Result.progress.logisticStage` (integer)
    Estágio logístico do processo.
    Enum: 0, 1, 2, 3, 4, 5, 6, 7

  - `Result.progress.financialStage` (integer)
    Estágio financeiro do processo.
    Enum: 0, 1, 2, 3, 4

  - `Result.progress.ratingStage` (integer)
    Estágio de rating do processo.
    Enum: 0, 1, 2

  - `Result.progress.stage` (integer)
    Estágio geral do processo.
    Enum: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11

  - `Result.progress.failures` (array)
    Falhas (se houver) registradas durante o processo.

  - `Result.notasDevolucao` (array)
    Coleção de notas de devolução associadas ao processo

  - `Result.notasDevolucao.numero` (string)
    Número da nota fiscal

  - `Result.notasDevolucao.serie` (string)
    Série da nota fiscal

  - `Result.notasDevolucao.chave` (string)
    Chave de acesso da nota fiscal

  - `Result.notasDevolucao.xml` (string)
    XML da nota fiscal

  - `Result.notasDevolucao.danfeLink` (string)
    Link do DANFE

  - `Result.notasDevolucao.data` (string,null)
    Data da nota fiscal

  - `Result.notasDevolucao.arquivo` (string)
    Arquivo da nota fiscal

  - `Records` (integer)
    Registros retornados

  - `HttpStatus` (string)
    Status http da requisição

  - `Err` (object)
    Conterá detalhes de um eventual erro

  - `Err.ErroCodigo` (string,null)
    Código do erro, caso tenha ocorrido

  - `Err.ErroDescricao` (string,null)
    Descrição do erro, caso tenha ocorrido

## Response 401 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (integer)

  - `detail` (string)

  - `instance` (string)

  - `traceId` (string)