# Integração do pedido ao fluxo de devolução

Endpoint utilizado para integrar um pedido da loja virtual à plataforma Genius Returns. Um link será disponibilizado pela API e poderá ser utilizado para redirecionar o usuário solicitante à interface Genius Returns de solicitação de troca ou devolução, diretamente ao estágio de seleção itens.

Endpoint: POST /v3/pvt/processo/integrar/fluxo
Version: 1.0.0
Security: BearerAuth

## Request fields (application/json):

  - `Pedido` (object)
    Pedido para integração do fluxo de solicitação de troca ou devolução

  - `Pedido.PedidoNumero` (string)
    Número do pedido

  - `Pedido.PedidoStatus` (string)
    Status do pedido

  - `Pedido.PedidoId` (string)
    Id do pedido no ecommerce

  - `Pedido.Cliente` (object)
    Cliente do pedido para integração do fluxo de solicitação de troca ou devolução

  - `Pedido.Cliente.ClienteNome` (string)
    Nome do cliente da loja virtual

  - `Pedido.Cliente.ClienteEmail` (string)
    Email do cliente da loja virtual

  - `Pedido.Cliente.ClienteTelefone` (string)
    Telefone do cliente da loja virtual

  - `Pedido.Cliente.ClienteCelular` (string)
    Celular do cliente da loja virtual

  - `Pedido.Cliente.ClienteDocumento` (string)
    CPF ou CNPJ do cliente na loja virtual

  - `Pedido.Cliente.ClienteEndereco` (object)
    Representa um endereço físico

  - `Pedido.Cliente.ClienteEndereco.logradouro` (string)
    Logradouro

  - `Pedido.Cliente.ClienteEndereco.numero` (string)
    Número

  - `Pedido.Cliente.ClienteEndereco.complemento` (string)
    Complemento

  - `Pedido.Cliente.ClienteEndereco.bairro` (string)
    Bairro

  - `Pedido.Cliente.ClienteEndereco.cidade` (string)
    Cidade

  - `Pedido.Cliente.ClienteEndereco.estado` (string)
    Estado

  - `Pedido.Cliente.ClienteEndereco.cep` (string)
    CEP

  - `Pedido.Cliente.ClienteEndereco.latitude` (string,null)
    Latitude

  - `Pedido.Cliente.ClienteEndereco.longitude` (string,null)
    Longitude

  - `Pedido.Cliente.ClienteEndereco.obs` (string,null)
    Observações gerais

  - `Pedido.PedidoData` (string)
    Data Hora do pedido

  - `Pedido.PedidoDataEntrega` (string,null)
    Data em que os pacotes do pedido foram entregues

  - `Pedido.PedidoValorTotal` (number)
    Valor do Pedido

  - `Pedido.PedidoValorFrete` (number)
    Valor do Frete do pedido

  - `Pedido.PedidoValorDesconto` (number,null)
    Valor de desconto

  - `Pedido.Skus` (array)
    Itens do pedido.

  - `Pedido.Skus.SkuId` (string)
    Id do SKU na loja virtual

  - `Pedido.Skus.SkuNome` (string)
    Nome do SKU

  - `Pedido.Skus.SkuReferencia` (string)
    Referencia do sku

  - `Pedido.Skus.SkuSellerReference` (string)
    Sku seller reference

  - `Pedido.Skus.ProdutoId` (string)
    Id do Produto na loja virtual

  - `Pedido.Skus.ProductRef` (string)

  - `Pedido.Skus.ProdutoNome` (string)
    Nome do Produto na loja virtual

  - `Pedido.Skus.Preco` (number)
    Preço do sku praticado no pedido

  - `Pedido.Skus.PrecoDeLista` (number)
    Preço da lista do sku - opcional

  - `Pedido.Skus.Quantidade` (integer)
    Quantidade total do sku no pedido

  - `Pedido.Skus.Peso` (number)
    Peso do sku em gramas

  - `Pedido.Skus.Altura` (number)
    Altura do sku em centímetros

  - `Pedido.Skus.Largura` (number)
    Largura do sku em centímetros

  - `Pedido.Skus.Comprimento` (number)
    Comprimento do sku em centímetros

  - `Pedido.Skus.SellerId` (string)
    Id do vendedor, necessário em ambientes Mkt Place

  - `Pedido.Skus.DocaId` (string)
    Id da doca

  - `Pedido.Skus.EstoqueId` (string)
    Id do estoque

  - `Pedido.Skus.ImagemAbsUrl` (string)
    Url absoluta da imagem do sku

  - `Pedido.Skus.Variacoes` (array)
    Atributos do sku

  - `Pedido.Skus.Variacoes.Nome` (string, required)
    Nome do atributo. Ex. Cor

  - `Pedido.Skus.Variacoes.Valores` (array, required)
    Valores do atributo. Ex. Preto

  - `Pedido.Skus.InvoiceKey` (string)
    Chave da nota fical - usado para cenários em que é necessário mapear um sku a uma nota fiscal específica.

  - `Pedido.Transacoes` (array)
    Transações de pagamento do pedido

  - `Pedido.Transacoes.TID` (string)
    Id da transação

  - `Pedido.Transacoes.SellerNomeId` (string)
    Nome identificador do seller dono da transação

  - `Pedido.Transacoes.Data` (string)
    Data do registro da transação na plataforma Genius

  - `Pedido.Transacoes.Pagamentos` (array)
    Pagamentos

  - `Pedido.Transacoes.Pagamentos.PId` (string)
    Id do pagamento

  - `Pedido.Transacoes.Pagamentos.TipoPagamento` (integer)
    Formas de pagamento
    Enum: 0, 1, 2, 3, 4, 5, 6, 7

  - `Pedido.Transacoes.Pagamentos.TipoPagamentoDescricao` (string)
    Descrição do tipo do pagamento

  - `Pedido.Transacoes.Pagamentos.Valor` (number)
    Valor do pagamento

  - `Pedido.Transacoes.Pagamentos.Parcelamento` (integer)
    Parcelamento do pagamento (installments). Se pagamento à vista, informe 1.

  - `Pedido.Transacoes.Pagamentos.ValorReferencia` (number)
    Valor de refernecia do pagamento, utilizado em caso de parcelamentos. Do contrário, informe o mesmo que o informado em 'Valor'.

  - `Pedido.Transacoes.Pagamentos.TID` (string)
    Tid. Se VTEX, deve conter o valor de paymentData.transactions[].payments[].connectorResponses.tid

  - `Pedido.Transacoes.Pagamentos.Nsu` (string)
    Nsu. Se VTEX, deve conter o valor de paymentData.transactions[].payments[].connectorResponses.nsu

  - `Pedido.Transacoes.Pagamentos.Adquirente` (string)
    Adquirente. Se VTEX, deve conter o valor de paymentData.transactions[].payments[].connectorResponses.acquirer

  - `Pedido.Transacoes.Pagamentos.Grupo` (string)
    Grupo do meio de pagamento. Se VTEX, deve conter o valor de paymentData.transactions[].payments[].group

  - `Pedido.NotasFiscais` (array)
    Notas fiscais

  - `Pedido.NotasFiscais.Number` (string)
    Número da nota fiscal

  - `Pedido.NotasFiscais.Series` (string)
    Série da nota fiscal

  - `Pedido.NotasFiscais.AccessKey` (string)
    Chave de acesso da nota fiscal

  - `Pedido.NotasFiscais.XML` (string)
    Xml da nota fiscal

  - `Pedido.NotasFiscais.DanfeLink` (string)
    Link Danfe

  - `Pedido.NotasFiscais.Data` (string)
    Data da nota fiscal

  - `Pedido.NotasFiscais.File` (string)
    Arquivo da nota fiscal

## Response 200 fields (application/json):

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

  - `Result` (string)
    Entidade relacionada

  - `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 400 fields (application/json):

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

  - `Result` (string)
    Entidade relacionada

  - `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):

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

  - `Result` (string)
    Entidade relacionada

  - `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