# Obtém um processo por ID Endpoint: GET /v3/pvt/processo/{id-processo} Version: 1.0.0 Security: BearerAuth ## Path parameters: - `id-processo` (string, required) Identificador do processo. ## Response 200 fields (application/json): - `Date` (string, required) Data e hora da resposta expressa em UTC - `Result` (object) Objeto principal do processo - `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, required) 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