> ## Documentation Index
> Fetch the complete documentation index at: https://reportana.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar/Atualizar Carrinho Abandonado

> Utilize este endpoint para criar um carrinho abandonado.

Utilize este **endpoint** para criar ou atualizar um **carrinho abandonado** em sua loja Reportana. O atributo `reference_id` é **obrigatório** e deve corresponder ao `id` ou à identificação exclusiva do carrinho abandonado em seu sistema, garantindo a sincronização correta entre os dados do seu sistema e nossa plataforma.

## Headers

<ParamField header="Authorization" type="string" required>
  Basic base64(client\_id + ':' + client\_secret)
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Content-Type:application/json
</ParamField>

## Body

<ParamField body="reference_id" type="string" required>
  Insira o ID de referência.

  Exemplo: "123456789".
</ParamField>

<ParamField body="reason_type" type="string" required>
  Insira o motivo do carrinho abandonado.

  Exemplo: null

  Opções disponíveis: `DECLINED_CREDIT_CARD`, `null`.
</ParamField>

<ParamField body="number" type="string" required>
  Insira o número do carrinho abandonado.

  Exemplo: "1234".
</ParamField>

<ParamField body="admin_url" type="string">
  Insira a URL de acesso do carrinho abandonado no painel de administração.

  Exemplo: "[https://example.com/admin/carts/123456789](https://example.com/admin/carts/123456789)".
</ParamField>

<ParamField body="customer_name" type="string" required>
  Insira o nome do cliente.

  Exemplo: "João Moraes".
</ParamField>

<ParamField body="customer_email" type="string" required>
  Insira o e-mail do cliente.

  Exemplo: "[joaomoraes@gmail.com](mailto:joaomoraes@gmail.com)".
</ParamField>

<ParamField body="customer_phone" type="string" required>
  Insira o telefone do cliente.

  Exemplo: "+5511911111111".
</ParamField>

### Billing Adress

<ParamField body="billing_address" type="object">
  Insira as informações de endereço de cobrança.

  <ParamField body="name" type="string">
    Insira o nome do cliente.

    Exemplo: João Moraes".
  </ParamField>

  <ParamField body="first_name" type="string">
    Insira o primeiro nome do cliente.

    Exemplo: "João".
  </ParamField>

  <ParamField body="last_name" type="string">
    Insira o sobrenome do cliente.

    Exemplo: "Moraes".
  </ParamField>

  <ParamField body="company" type="string">
    Insira o nome da empresa.

    Exemplo: "João Moraes Ltda".
  </ParamField>

  <ParamField body="phone" type="string">
    Insira o telefone do cliente.

    Exemplo: "+5511911111111".
  </ParamField>

  <ParamField body="address1" type="string">
    Insira o endereço do cliente.

    Exemplo: "Av Belisário Ramos, 3735".
  </ParamField>

  <ParamField body="address2" type="string">
    Insira o bairro do cliente.

    Exemplo: "Sagrado Coração Jesus".
  </ParamField>

  <ParamField body="city" type="string">
    Insira a cidade do cliente.

    Exemplo: "Lages".
  </ParamField>

  <ParamField body="province" type="string">
    Insira o estado do cliente.

    Exemplo: "Santa Catarina".
  </ParamField>

  <ParamField body="province_code" type="string">
    Insira o código do estado do cliente.

    Exemplo: "SC".
  </ParamField>

  <ParamField body="country" type="string">
    Insira o país do cliente.

    Exemplo: "Brazil".
  </ParamField>

  <ParamField body="country_code" type="string">
    Insira o código do país do cliente.

    Exemplo: "BR".
  </ParamField>

  <ParamField body="zip" type="string">
    Insira o CEP do cliente.

    Exemplo: "88508100".
  </ParamField>

  <ParamField body="latitude" type="string">
    Insira a latitude do cliente.

    Exemplo: -50.3183162423294
  </ParamField>

  <ParamField body="longitude" type="string">
    Insira a longitude do cliente.

    Exemplo: -27.807915923881836
  </ParamField>
</ParamField>

### Shipping Adress

<ParamField body="shipping_address" type="object">
  Insira as informações de endereço de entrega.

  <ParamField body="name" type="string">
    Insira o nome do cliente.

    Exemplo: João Moraes".
  </ParamField>

  <ParamField body="first_name" type="string">
    Insira o primeiro nome do cliente.

    Exemplo: "João".
  </ParamField>

  <ParamField body="last_name" type="string">
    Insira o sobrenome do cliente.

    Exemplo: "Moraes".
  </ParamField>

  <ParamField body="company" type="string">
    Insira o nome da empresa.

    Exemplo: "João Moraes Ltda".
  </ParamField>

  <ParamField body="phone" type="string">
    Insira o telefone do cliente.

    Exemplo: "+5511911111111".
  </ParamField>

  <ParamField body="address1" type="string">
    Insira o endereço do cliente.

    Exemplo: "Av Belisário Ramos, 3735".
  </ParamField>

  <ParamField body="address2" type="string">
    Insira o bairro do cliente.

    Exemplo: "Sagrado Coração Jesus".
  </ParamField>

  <ParamField body="city" type="string">
    Insira a cidade do cliente.

    Exemplo: "Lages".
  </ParamField>

  <ParamField body="province" type="string">
    Insira o estado do cliente.

    Exemplo: "Santa Catarina".
  </ParamField>

  <ParamField body="province_code" type="string">
    Insira o código do estado do cliente.

    Exemplo: "SC".
  </ParamField>

  <ParamField body="country" type="string">
    Insira o país do cliente.

    Exemplo: "Brazil".
  </ParamField>

  <ParamField body="country_code" type="string">
    Insira o código do país do cliente.

    Exemplo: "BR".
  </ParamField>

  <ParamField body="zip" type="string">
    Insira o CEP do cliente.

    Exemplo: "88508100".
  </ParamField>

  <ParamField body="latitude" type="string">
    Insira a latitude do cliente.

    Exemplo: -27.807915923881836
  </ParamField>

  <ParamField body="longitude" type="string">
    Insira a longitude do cliente.

    Exemplo: -50.3183162423294
  </ParamField>
</ParamField>

### Line Items

<ParamField body="line_items" type="object[]">
  Clique em "Add an item" para adicionar um produto.

  <ParamField body="title" type="string">
    Insira o título do produto.

    Exemplo: "Óculos".
  </ParamField>

  <ParamField body="variant_title" type="string">
    Insira o título da variante do produto.

    Exemplo: "Preto".
  </ParamField>

  <ParamField body="quantity" type="number">
    Insira a quantidade de produtos no carrinho abandonado.

    Exemplo: 1
  </ParamField>

  <ParamField body="price" type="number">
    Insira o valor do produto.

    Exemplo: 49.9
  </ParamField>

  <ParamField body="path" type="string">
    Insira a URL de acesso público do produto.

    Exemplo: "[https://example.com/products/1234](https://example.com/products/1234)".
  </ParamField>

  <ParamField body="image_url" type="string">
    Insira a URL da imagem do produto.

    Exemplo: "[https://example.com/products/1234/image.jpg](https://example.com/products/1234/image.jpg)".
  </ParamField>
</ParamField>

### Checkout & More Info

<ParamField body="currency" type="string" required>
  Insira a moeda do carrinho abandonado.

  Exemplo: "BRL".
</ParamField>

<ParamField body="total_price" type="number" required>
  Insira o valor total do carrinho abandonado.

  Exemplo: 124.8
</ParamField>

<ParamField body="subtotal_price" type="number" required>
  Insira o valor subtotal do carrinho abandonado.

  Exemplo: 109.8
</ParamField>

<ParamField body="referring_site" type="string">
  Insira a URL do seu site.

  Exemplo: "[https://www.facebook.com/](https://www.facebook.com/)".
</ParamField>

<ParamField body="checkout_url" type="string">
  Insira a URL para o link de checkout.

  Exemplo: "[https://example.com/carts/123456789](https://example.com/carts/123456789)".
</ParamField>

<ParamField body="completed_at" type="string">
  Insira a data em que o carrinho foi completado.

  Exemplo: "2022-05-31 23:59".
</ParamField>

<ParamField body="original_created_at" type="string" required>
  Insira a data de criação do carrinho abandonado.

  Exemplo: "2022-05-27 12:00".
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": null
  }
  ```

  ```json 4XX theme={null}
  {
    "success": false,
    "message": "Verifique o preenchimento dos campos.",
    "errors": {
      "reference_id": [
        "O campo reference id é obrigatório."
      ],
      "number": [
        "O campo number é obrigatório."
      ],
      "customer_name": [
        "O campo customer name é obrigatório."
      ],
      "customer_email": [
        "O campo customer email é obrigatório."
      ],
      "customer_phone": [
        "O campo customer phone é obrigatório."
      ],
      "currency": [
        "O campo currency é obrigatório."
      ],
      "total_price": [
        "O campo total price é obrigatório."
      ],
      "subtotal_price": [
        "O campo subtotal price é obrigatório."
      ],
      "checkout_url": [
        "O campo checkout url é obrigatório."
      ],
      "original_created_at": [
        "O campo original created at é obrigatório."
      ]
    }
  }
  ```
</ResponseExample>