> For the complete documentation index, see [llms.txt](https://docs.gestao.plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gestao.plus/api/ecommerce/api_integration.md).

# Integração API

## URL Checkout

<mark style="color:green;">`POST`</mark> `https://tools.gestao.plus/goto-checkout.php`

Este endpoint permite que você gere uma URL para acessar o checkout com os devidos parâmetros.

#### Headers

| Name                                           | Type   | Description      |
| ---------------------------------------------- | ------ | ---------------- |
| Accept<mark style="color:red;">\*</mark>       | string | application/json |
| Content-Type<mark style="color:red;">\*</mark> | string | application/json |

#### Request Body

| Name                                  | Type   | Description                                                                                                                                                                        |
| ------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| user                                  | string | Dados do usuário para o preenchimento automático do formulário                                                                                                                     |
| sku<mark style="color:red;">\*</mark> | string | SKU do produto dessa venda                                                                                                                                                         |
| callBackUrl                           | string | URL de volta para o usuário retornar para o carrinho, se for necessário                                                                                                            |
| callBackResponseUrl                   | string | URL de volta para o usuário retornar para resumo de compra após a confirmação do pagamento, se for necessário (a url deve esperar a concatenação do parâmetro de código do pedido) |
| p                                     | string | ID gerado dentro do sistema (consulte o administrador)                                                                                                                             |
| url<mark style="color:red;">\*</mark> | string | URL do ERP Gestão Online                                                                                                                                                           |

{% tabs %}
{% tab title="200 " %}

```
{
    "status": "success",
    "redirectTo":
    "https://dev.gestao.plus/loja/checkout?p=i1-contabilidade-indicador&loc
    k=1&item=eyJyYW5kIjoxLCJza3UiOjEwfQ%3D%3D&payload=eyJkb2
    N1bWVudCI6IjExMTExMTExMTExIiwibmFtZSI6Ik5vbWUgRXhlbXBsb
    yIsImVtYWlsIjoidGVzdGVAdGVzdGUuY29tIiwiY2VsbHBob25lIjoiNjI5O
    TU1NTU1NTUiLCJ6aXBDb2RlIjoiNzQyMzAxMzAiLCJhZGRyZXNzIjoi
    QXB0IDEyMyIsIm51bWJlciI6IjE1MjkiLCJuZWlnaGJvcmhvb2QiOiJTZX
    RvciBCdWVubyIsImFkZHJlc3NEZXRhaWwiOiJBdiBYcHRvIiwiY2l0eSI
    6IkdvaWFuaWEiLCJzdGF0ZSI6IkdPIn0%3D&callBackUrl=https%3A%
    2F%2Fseusiteintegrado.com.br%2Fexemplo%2F123"
}
```

{% endtab %}

{% tab title="400 " %}

```
{
    "status": "error",
    "message": "An error occurred, the 'url' parameter is invalid"
}
```

{% endtab %}
{% endtabs %}

Exemplo de request:

```
curl --location --request POST 'https://tools.gestao.plus/goto-checkout.php' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://parceirosoluti.com.br",
    "p": "i6473-gestao-online",
    "callBackUrl": "https://gestão.online?q=callbackToProductListSample",
    "callBackResponseUrl": "https://gestão.online?q=callbackToOrderDetailUsingCode&code=",
    "sku": 9,
    "user": {
        "document": "11111111111",
        "name": "Nome Exemplo",
        "email": "teste@teste.com",
        "cellphone": "62995555555",
        "zipCode": "74230130",
        "address": "Apt 123",
        "number": "1529",
        "neighborhood": "Setor Bueno",
        "addressDetail": "Av Xpto",
        "city": "Goiania",
        "state": "GO"
    }
}'
```

{% hint style="info" %}
Para consultar as informações utilize o código retornado na url indicada em "callBackResponseUrl", [utilize o endpoint de detalhes do pedido/pagamento](https://docs.gestao.plus/api/public/order_details_public) para obter os detalhes.
{% endhint %}