Criação e Avaliação de Pedidos

Search…
Visão geral
Você pode enviar informações relacionadas a pedidos para a Legiti por meio do endpoint /order, que suporta requisições POST (create). Nesse endpoint você pode especificar, por meio da flag evaluate, se deseja ou não receber uma avaliação da Legiti para o pedido. Caso deseje receber a avaliação da Legiti é importante que você trate a resposta da API de modo diferente.
Quando rastrear
Quando um pedido é criado​
Você pode ver mais informações sobre onde adicionar estes endpoints no seu fluxo de pagamento aqui​
Entidades
Pedido
1
{
2
    "id": "12345",
3
    "evaluate": true,
4
    "total_paid_value": 110.0,
5
    "total_gross_value": 100.0,
6
    "discount_value": 10.0,
7
    "shipping_value": 10.0,
8
    "tip_value": 5.0,
9
    "coupon_names": ["LOTR"],
10
    "currency": "BRL",
11
    "status": "pending",
12
    "creation_datetime": "2020-02-10T20:18:40Z",
13
    "tax_invoice_document_type": "cpf",
14
    "tax_invoice_document": "12345678911",
15
    "user": {
16
        "id": "98745",
17
        "name":"john fulano",
18
        "email": "[email protected]",
19
        "document": "123.456.789-10",
20
        "document_type": "cpf",
21
        "phone_number": "11999123456",
22
        "phone_country_code":"55",
23
        "password_hash": "effebbbeeabc123",
24
        "gender": "male",
25
        "social_login": "facebook",
26
        "creation_datetime": "2019-12-17T00:48:03Z",
27
        "address": {
28
            "street_name": "Rua Fidalga",
29
            "street_number": "252",
30
            "zip_code": "05432-010",
31
            "city": "São Paulo",
32
            "state": "SP",
33
            "country": "BR",
34
            "details": "Apto 11",
35
            "label": "Casa"
36
        }
37
    },
38
    "items": [
39
        {
40
            "quantity":2,
41
            "unit_price":30,
42
            "unit_discount":0,
43
            "total_value":60,
44
            "product": {
45
                "sku": "15975368",
46
                "title": "Product A",
47
                "product_id": "123",
48
                "ean": "1589461449846",
49
                "description": "Cool Product A",
50
                "categories": ["8"],
51
                "seller": {
52
                    "id": "852456",
53
                    "name": "Meu Marketplace",
54
                    "description": "O melhor marketplace de todos",
55
                    "email": "[email protected]",
56
                    "categories": ["9", "45"],
57
                    "subcategories": ["4541", "41546"],
58
                    "document_type": "cnpj",
59
                    "document": "45.543.948/0001-00",
60
                    "phone_country_code": "+55",
61
                    "phone_number": "1138544649",
62
                    "creation_datetime": "2019-12-17T00:48:03Z",
63
                    "address": {
64
                        "street_name": "Rua Fidalga",
65
                        "street_number": "252",
66
                        "zip_code": "05432-010",
67
                        "city": "São Paulo",
68
                        "state": "SP",
69
                        "country": "BR",
70
                        "details": "Conjunto 15"
71
                    }
72
                }
73
            },
74
            "delivery": {
75
                "id": "1569723",
76
                "type": "normal",
77
                "scheduled": false,
78
                "deliverer": {
79
                    "id": "456987",
80
                    "name": "João Entregador"
81
                }
82
            }
83
        },
84
        {
85
            "quantity":1,
86
            "unit_price":50.0,
87
            "unit_discount":10.0,
88
            "total_value":40.0,
89
            "product": {
90
                "sku": "75363418",
91
                "title": "Product B",
92
                "product_id": "456",
93
                "ean": "4194874146871",
94
                "description": "Cool Product B",
95
                "categories": ["8", "9"],
96
                "seller": {
97
                    "id": "74123",
98
                    "name": "Meu Marketplace 2",
99
                    "description": "O segundo melhor marketplace de todos",
100
                    "email": "[email protected]",
101
                    "categories": ["9", "45"],
102
                    "subcategories": ["4541", "41546"],
103
                    "document_type": "cnpj",
104
                    "document": "77.852.965/0001-00",
105
                    "phone_country_code": "+55",
106
                    "phone_number": "1138555649",
107
                    "creation_datetime": "2019-12-17T00:48:03Z",
108
                    "address": {
109
                        "street_name": "Rua Fidalga",
110
                        "street_number": "253",
111
                        "zip_code": "05432-010",
112
                        "city": "São Paulo",
113
                        "state": "SP",
114
                        "country": "BR",
115
                        "details": "Conjunto 15"
116
                    }
117
                }
118
            },
119
            "delivery": {
120
                "id": "1569723",
121
                "type": "normal",
122
                "scheduled": false,
123
                "deliverer": {
124
                    "id": "456987",
125
                    "name": "João Entregador"
126
                }
127
            }
128
        }
129
    ],
130
    "payments": [
131
        {
132
            "id": "974613",
133
            "method": "credit_card",
134
            "payment_value": 110.0,
135
            "installments": 1,
136
            "interest": 0.1,
137
            "document_type": "cpf",
138
            "document": "12345678911",
139
            "credit_card": {
140
                "first_six_digits": "123456",
141
                "last_four_digits": "1234",
142
                "expiration_date": "23/05",
143
                "holder_name": "Random da Silva"
144
            },
145
            "billing_address": {
146
                "street_name": "Rua Fidalga",
147
                "street_number": "252",
148
                "zip_code": "05432-010",
149
                "city": "São Paulo",
150
                "state": "SP",
151
                "country": "BR"
152
            }
153
        }
154
    ],
155
    "shipping_address": {
156
        "street_name": "Rua Fidalga",
157
        "street_number": "252",
158
        "zip_code": "05432-010",
159
        "city": "São Paulo",
160
        "state": "SP",
161
        "country": "BR",
162
        "details": "Apto 308",
163
        "label": "Home"
164
    }
165
}
Copied!
Propriedade
Tipo
Descrição
id
String
O identificador exclusivo do pedido na sua plataforma. Este é o id que será usado nos dashboards fornecidos pela Legiti
evaluate
Boolean
Indica se a Legiti deve retornar ou não uma avaliação sobre o pedido
user
​Usuário​
Informações sobre o comprador
total_paid_value
Float
O valor exato que o usuário pagou pelo pedido (total_paid_value = total_gross_value + shipping_value + tip_value - discount_value)
total_gross_value
Float
A soma dos valores de todos os itens do pedido, sem adicionar shipping_value, discount_value e tip_value
discount_value
Float
O valor do desconto aplicado ao pedido
shipping_value
Float
Valor do frete
tip_value
Float
A gorjeta paga pelo usuário ao entregador
coupon_names
Array de Strings
Os nomes dos cupons que foram aplicados. Nota: se coupon_names é fornecido, discount_value também é obrigatório
currency
String
A moeda do total_paid_value, como um código de moeda ISO-4217
status
String
Status do pedido. Valores permitidos: approved, declined, pending, cancelled, manual_analysis, unauthorized. Você pode ver mais sobre isso aqui​
status_reason
String
O motivo para a mudança de status.
tax_invoice_document_type
String
O tipo de documento associado com a nota fiscal. Valores aceitos são cpf, cnpj e other
tax_invoice_document
String
O número do documento associado com a nota fiscal
items
Array de Item​
Os itens comprados (por exemplo, produtos)
payments
Array de Pagamento​
Os pagamentos usados nesta compra
shipping_address
​Address​
Endereço da entrega. Não é necessário se o produto não requer envio
creation_datetime
String
A data e hora em que o pedido foi criado. Este deve ser o mesmo horário em que o pedido foi enviado para o endpoint de avaliação.O valor deve estar em UTC seguindo o formato ISO 8601 (YYYY-MM-DDTHH:mm:ssZ)
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
Usuário
Formato padronizado da Legiti para representar usuários.
1
{
2
    "id":                  "12345",
3
    "email":               "[email protected]",
4
    "document":            "123.456.789-10",
5
    "document_type":       "cpf",
6
    "phone_number":        "11999123456",
7
    "phone_country_code":  "55",
8
    "password_hash":       "effebbbeeabc123",
9
    "name":                "john fulano",
10
    "gender":              "male",
11
    "user_type":           "consumidor",
12
    "social_login":        "facebook",
13
    "creation_datetime":   "2019-12-17T00:48:03Z",
14
    "address":             {
15
        "street_name":       "Rua Fidalga",
16
        "street_number":     "252",
17
        "zip_code":          "05432-010",
18
        "city":              "São Paulo",
19
        "state":             "SP",
20
        "country":           "BR",
21
        "details":           "Apto 11",
22
        "label":             "Casa"
23
    }
24
}
Copied!
Propriedade
Tipo
Descrição
id
String
O identificador exclusivo do usuário na sua plataforma
email
String
O e-mail principal associado ao usuário
document
String
O número do documento associado ao usuário
document_type
String
O tipo do documento utilizado. Valores aceitos são cpf, cnpj, passport, rg, rne e other
phone_number
String
O número de telefone principal associado ao usuário (apenas números; código do país não incluído). Nota: se o phone_number é fornecido, phone_country_code também é obrigatório
phone_country_code
String
Código do país associado ao número de telefone (apenas números). Nota: se o phone_country_code é fornecido, phone_number também é obrigatório
password_hash
String
A senha protegida (salted e hashed) associada com o usuário
name
String
Nome completo do usuário
gender
String
O gênero do usuário. Os valores aceitos são: male, female, other, e undisclosed
social_login
String
Se o usuário se cadastrou usando um serviço de terceiros. Valores aceitos são: facebook, apple, google, twitter
creation_datetime
String (formato YYYY-MM-DDTHH:mm:ssZ em UTC)
A data e hora de quando a conta do usuário foi criada
address
​Address​
O endereço associado ao usuário
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
Item
Formato padronizado da Legiti para representar itens comprados.
1
{
2
    "quantity":2,
3
    "unit_price":30,
4
    "unit_discount":0,
5
    "total_value":60,
6
    "product": {
7
        "sku": "15975368",
8
        "title": "Product A",
9
        "product_id": "123",
10
        "ean": "1589461449846",
11
        "description": "Cool Product A",
12
        "categories": ["8"],
13
        "seller": {
14
            "id": "852456",
15
            "name": "Meu Marketplace",
16
            "description": "O melhor marketplace de todos",
17
            "email": "[email protected]",
18
            "categories": ["9", "45"],
19
            "subcategories": ["4541", "41546"],
20
            "document_type": "cnpj",
21
            "document": "45.543.948/0001-00",
22
            "phone_country_code": "+55",
23
            "phone_number": "1138544649",
24
            "creation_datetime": "2019-12-17T00:48:03Z",
25
            "address": {
26
                "street_name": "Rua Fidalga",
27
                "street_number": "252",
28
                "zip_code": "05432-010",
29
                "city": "São Paulo",
30
                "state": "SP",
31
                "country": "BR",
32
                "details": "Conjunto 15"
33
            }
34
        }
35
    },
36
    "delivery": {
37
        "id": "1569723",
38
        "type": "normal",
39
        "delivery_datetime": "2020-02-11T20:18:40Z",
40
        "scheduled": false,
41
        "deliverer": {
42
            "id": "456987",
43
            "name": "João Entregador"
44
        }
45
    }
Copied!
Propriedade
Tipo
Descrição
quantity
Integer
A quantidade comprada deste produto
unit_price
Float
Preço unitário do produto comprado
unit_discount
Float
O valor do desconto aplicado a cada unidade deste produto
total_value
Float
O valor total pago por este produto
product
​Produto​
Dados do produto comprado
delivery
​Delivery​
Dados da entrega associada
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
Produto
Formato padronizado da Legiti para representar produtos.
1
{
2
    "sku": "15975368",
3
    "title": "Product A",
4
    "product_id": "123",
5
    "ean": "1589461449846",
6
    "description": "Cool Product A",
7
    "categories": ["8"],
8
    "seller": {
9
        "id": "852456",
10
        "name": "Meu Marketplace",
11
        "description": "O melhor marketplace de todos",
12
        "email": "[email protected]",
13
        "categories": ["9", "45"],
14
        "subcategories": ["4541", "41546"],
15
        "document_type": "cnpj",
16
        "document": "45.543.948/0001-00",
17
        "phone_country_code": "+55",
18
        "phone_number": "1138544649",
19
        "creation_datetime": "2019-12-17T00:48:03Z",
20
        "address": {
21
            "street_name": "Rua Fidalga",
22
            "street_number": "252",
23
            "zip_code": "05432-010",
24
            "city": "São Paulo",
25
            "state": "SP",
26
            "country": "BR",
27
            "details": "Conjunto 15"
28
        }
29
}
Copied!
Propriedade
Tipo
Descrição
sku
String
Código de SKU do produto ou seu identificador exclusivo na sua plataforma
title
String
O nome do produto
product_id
String
ID secundário do produto (pode ser o ID do produto principal caso esta seja apenas uma variação)
ean
String
O número do código de barras do produto
Seller
​Seller​
O id do vendedor do produto
description
String
A descrição do produto
categories
Array de String
As categorias desse produto na sua plataforma. (Categorias arbitrárias são aceitas, mas devem ser consistentes.)
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
Seller
1
{
2
    "id": "852456",
3
    "name": "Meu Marketplace",
4
    "description": "O melhor marketplace de todos",
5
    "email": "[email protected]",
6
    "categories": ["9", "45"],
7
    "subcategories": ["4541", "41546"],
8
    "document_type": "cnpj",
9
    "document": "45.543.948/0001-00",
10
    "phone_country_code": "+55",
11
    "phone_number": "1138544649",
12
    "creation_datetime": "2019-12-17T00:48:03Z",
13
    "address": {
14
        "street_name": "Rua Fidalga",
15
        "street_number": "252",
16
        "zip_code": "05432-010",
17
        "city": "São Paulo",
18
        "state": "SP",
19
        "country": "BR",
20
        "details": "Conjunto 15"
21
    }
22
}
Copied!
Propriedade
Tipo
Descrição
id
String
O identificador exclusivo do seller (vendedor) na sua plataforma. Este é o id que será usado nos painéis fornecidos pela Legiti
name
String
Nome do seller (vendedor)
description
String
Descrição fornecida pelo seller
email
String
Email principal associado ao seller
categories
Array of String
Categorias associadas ao seller
subcategories
Array of String
Subcategorias associadas ao seller
document
String
Número do documento associado ao seller
document_type
String
Tipo de documento do número do documento do seller. Valores aceitos são cpf, cnpj e other
phone_number
String
Número de telefone principal associado ao seller(apenas números; código do país não incluído). Nota: se o phone_number é fornecido, phone_country_code também é obrigatório
phone_country_code
String
Código do país associado ao número de telefone (apenas números). Nota: se o phone_country_code é fornecido, phone_number também é obrigatório
creation_datetime
String (formato YYYY-MM-DDTHH:mm:ssZ em UTC)
A data e hora em que o cadastro do seller foi criado
address
​Address​
Endereço associado ao seller
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
Delivery
Formato padronizado da Legiti para representar uma entrega.
1
{
2
    "id": "1569723",
3
    "type": "normal",
4
    "scheduled": false,
5
    "deliverer": {
6
        "id": "456987",
7
        "name": "João Entregador"
8
    }
9
}
Copied!
Propriedade
Tipo
Descrição
id
String
O identificador exclusivo da entrega (delivery) em sua plataforma. Saiba que esse é o ID usado para atualizar as informações de entrega posteriormente
type
String
O tipo de entrega (delivery). Os valores permitidos são: normal, express, e pickup
delivery_datetime
String
Data em que o item foi entregue em UTC seguindo o formato ISO 8601 (YYYY-MM-DDTHH:mm:ssZ). Esse valor, normalmente, será recebido pelo endpoint de atualização de entregas.
deliverer
​Entregador​
Informações sobre o entregador da encomenda
scheduled
Boolean
Indica se a entrega está agendada para uma data futura
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
Entregador
Formato padronizado da Legiti para representar um entregador.
1
{
2
    "id": "456987",
3
    "name": "João Entregador",
4
    "email": "[email protected]",
5
    "document": "123.456.789-10",
6
    "document_type": "cpf",
7
    "phone_number": "11999123456",
8
    "phone_country_code": "55",
9
    "password_hash": "effebbbeeabc123",
10
    "gender": "male",
11
    "creation_datetime": "2019-12-17T00:48:03Z",
12
    "address":             {
13
        "street_name": "Rua Fidalga",
14
        "street_number": "252",
15
        "zip_code": "05432-010",
16
        "city": "São Paulo",
17
        "state": "SP",
18
        "country": "BR",
19
        "details": "Apto 11",
20
        "label": "Casa"
21
    }
22
}
Copied!
Propriedade
Tipo
Descrição
id
String
O identificador exclusivo do entregador na sua plataforma
email
String
O e-mail principal associado ao entregador
document
String
O número do documento associado ao entregador
document_type
String
O tipo do documento utilizado. Valores aceitos são cpf, cnpj, passport, rg, rne e other
phone_number
String
O número de telefone principal associado ao entregador (apenas números; código do país não incluído). Nota: se o phone_number é fornecido, phone_country_code também é obrigatório
phone_country_code
String
Código do país associado ao número de telefone (apenas números). Nota: se o phone_country_code é fornecido, phone_number também é obrigatório
senha_hash
String
A senha protegida (salted e hashed) associada com o entregador
name
String
Nome completo do entregador
gender
String
O gênero do entregador. Os valores aceitos são: male, female, other, e undisclosed
user_type
String
O tipo de entregador na sua plataforma. Os valores aceitos são: consumer, service_provider
social_login
String
Se o entregador se cadastrou usando um serviço de terceiros. Valores aceitos são: facebook, apple, google, twitter
creation_datetime
String (formato YYYY-MM-DDTHH:mm:ssZ em UTC)
A data e hora de quando a conta do entregador foi criada
address
​Address​
O endereço associado ao entregador
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
Pagamento
Formato padronizado da Legiti para representar pagamentos de um pedido.
1
{
2
    "id": "974613",
3
    "acquired_id": "123654789",
4
    "method": "credit_card",
5
    "payment_value": 110.0,
6
    "installments": 1,
7
    "interest": 0.1,
8
    "document_type": "cpf",
9
    "document": "12345678911",
10
    "credit_card": {
11
        "first_six_digits": "123456",
12
        "last_four_digits": "1234",
13
        "expiration_date": "23/05",
14
        "holder_name": "Random da Silva"
15
    },
16
    "billing_address":{
17
        "street_name": "Rua Fidalga",
18
        "street_number": "252",
19
        "zip_code": "05432-010",
20
        "city": "São Paulo",
21
        "state": "SP",
22
        "country": "BR"
23
    }
24
}
Copied!
Propriedade
Tipo
Descrição
id
String
O identificador único do pagamento na sua plataforma. Se não tiver um, pode nos enviar o identificador do pedido. Este é o identificador a ser usado no futuro se você precisar atualizar as informações de pagamento
acquirer_id
String
O identificador único para cada transação retornada pela adquirente/gateway. Este identificador é usado para vincular chargebacks
method
String
Método de pagamento. Valores aceitos: credit_card, boleto, wallet, cash, vr (vale refeição), pix, transfer, apple_pay, goole_pay e other
payment_value
Float
O montante pago
installments
Integer
O número de parcelas a serem pagas.
interest
Float
A taxa de juros aplicada - onde 0 significa que não foram aplicados juros e 1 significa 100% de juros mensais
document_type
String
Tipo de documento associado ao pagamento. Valores aceitos são cpf, cnpj, passport, rg, rne e other
document
String
Número do documento associado ao pagamento
credit_card
​Cartão de Crédito​
Cartão de crédito associado ao pagamento. Observação: credit_card é necessário somente se o método de pagamento é credit_card
billing_address
​Address​
Endereço de cobrança associado ao pagamento. Observação: billing_address é necessário somente se o método de pagamento for credit_card ou boleto
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
Cartão de Crédito
Formato padronizado da Legiti para representar as informações de cartão de crédito de um pagamento.
1
{
2
    "first_six_digits": "123456",
3
    "last_four_digits": "1234",
4
    "expiration_date": "23/05",
5
    "holder_name": "Random da Silva"
6
}
Copied!
Propriedade
Tipo
Descrição
Placeholder Values*
first_six_digits
String
Os seis primeiros dígitos do número do cartão de crédito (devem ser apenas dígitos)
999999
last_four_digits
String
Os últimos quatro dígitos do número do cartão de crédito (devem ser apenas dígitos)
9999
expiration_date
String
A data de vencimento do cartão de crédito, com formato mm/yy
XX/XX
holder_name
String
O nome completo do titular do cartão de crédito.
Indisponível
custom_data
​Dados customizáveis​
JSON para captura de dados customizados para cada cliente
-
*Caso você não possua alguma das informações de cartão de crédito você pode utilizar esses valores como placeholder no lugar da informação faltante
Descrição dos Status
Status de Pedido
Estas são as descrições para o campo status na entidade Pedido:
Status do pedido
Status
Descrição
approved
O pedido foi aprovado e é esperado que seja entregue ao consumidor
declined
O pedido foi rejeitado por suspeita de fraude (tanto da Legiti ou por outro provedor de anti-fraude)
pending
O pedido não foi nem rejeitado, nem aprovado, e seu pagamento ainda não foi processado. Você ainda está decidindo se deve aprovar ou rejeitar o pedido
cancelled
O pedido foi cancelado ou reembolsado e não será mais entregue ou o consumidor está devolvendo
manual_analysis
O pedido foi enviado a um humano para revisão
unauthorized
O pagamento não foi aprovado pela adquirente
Endpoints da API
Criação e Avaliação de pedidos
POST https://legiti-api.lgtcdn.net/v2/order​
Para receber a avaliação do pedido a flag evaluate deve ser true
Notifica a Legiti sempre que um novo pedido for criado. Caso a flag evaluate seha true o endpoint irá retornar a avaliação da Legiti para o pedido.
A Legiti deve receber todos os pedidos da plataforma, até mesmo aqueles que não são de cartão de crédito já que esses pedidos podem ser usados para a avaliação de outros pedidos. Importante ressaltar que para pedidos que não são de cartão de crédito a flag evaluate deve ser false
É importante aderir às nossas melhores práticas de tratamento de erros de API​
Curl
Python
Node.js
PHP
Ruby
Java
1
curl -X POST https://legiti-api.lgtcdn.net/v2/order \
2
    -H "Content-Type: application/json" \
3
    -H "Authorization: Bearer $API_KEY" \
4
    -d '{
5
        "id": "12345",
6
        "evaluate": true,
7
        "total_paid_value": 110.0,
8
        "total_gross_value": 100.0,
9
        "discount_value": 10.0,
10
        "shipping_value": 10.0,
11
        "tip_value": 5.0,
12
        "coupon_names": ["LOTR"],
13
        "currency": "BRL",
14
        "status": "pending",
15
        "creation_datetime": "2020-02-10T20:18:40Z",
16
        "tax_invoice_document_type": "cpf",
17
        "tax_invoice_document": "12345678911",
18
        "user": {
19
            "id": "98745",
20
            "name":"john fulano",
21
            "email": "[email protected]",
22
            "document": "123.456.789-10",
23
            "document_type": "cpf",
24
            "phone_number": "11999123456",
25
            "phone_country_code":"55",
26
            "password_hash": "effebbbeeabc123",
27
            "gender": "male",
28
            "social_login": "facebook",
29
            "creation_datetime": "2019-12-17T00:48:03Z",
30
            "address": {
31
                "street_name": "Rua Fidalga",
32
                "street_number": "252",
33
                "zip_code": "05432-010",
34
                "city": "São Paulo",
35
                "state": "SP",
36
                "country": "BR",
37
                "details": "Apto 11",
38
                "label": "Casa"
39
            }
40
        },
41
        "items": [
42
            {
43
                "quantity":2,
44
                "unit_price":30,
45
                "unit_discount":0,
46
                "total_value":60,
47
                "product": {
48
                    "sku": "15975368",
49
                    "title": "Product A",
50
                    "product_id": "123",
51
                    "ean": "1589461449846",
52
                    "description": "Cool Product A",
53
                    "categories": ["8"],
54
                    "seller": {
55
                        "id": "852456",
56
                        "name": "Meu Marketplace",
57
                        "description": "O melhor marketplace de todos",
58
                        "email": "[email protected]",
59
                        "categories": ["9", "45"],
60
                        "subcategories": ["4541", "41546"],
61
                        "document_type": "cnpj",
62
                        "document": "45.543.948/0001-00",
63
                        "phone_country_code": "+55",
64
                        "phone_number": "1138544649",
65
                        "creation_datetime": "2019-12-17T00:48:03Z",
66
                        "address": {
67
                            "street_name": "Rua Fidalga",
68
                            "street_number": "252",
69
                            "zip_code": "05432-010",
70
                            "city": "São Paulo",
71
                            "state": "SP",
72
                            "country": "BR",
73
                            "details": "Conjunto 15"
74
                        }
75
                    }
76
                },
77
                "delivery": {
78
                    "id": "1569723",
79
                    "type": "normal",
80
                    "scheduled": false,
81
                    "deliverer": {
82
                        "id": "456987",
83
                        "name": "João Entregador"
84
                    }
85
                }
86
            },
87
            {
88
                "quantity":1,
89
                "unit_price":50.0,
90
                "unit_discount":10.0,
91
                "total_value":40.0,
92
                "product": {
93
                    "sku": "75363418",
94
                    "title": "Product B",
95
                    "product_id": "456",
96
                    "ean": "4194874146871",
97
                    "description": "Cool Product B",
98
                    "categories": ["8", "9"],
99
                    "seller": {
100
                        "id": "74123",
101
                        "name": "Meu Marketplace 2",
102
                        "description": "O segundo melhor marketplace de todos",
103
                        "email": "[email protected]",
104
                        "categories": ["9", "45"],
105
                        "subcategories": ["4541", "41546"],
106
                        "document_type": "cnpj",
107
                        "document": "77.852.965/0001-00",
108
                        "phone_country_code": "+55",
109
                        "phone_number": "1138555649",
110
                        "creation_datetime": "2019-12-17T00:48:03Z",
111
                        "address": {
112
                            "street_name": "Rua Fidalga",
113
                            "street_number": "253",
114
                            "zip_code": "05432-010",
115
                            "city": "São Paulo",
116
                            "state": "SP",
117
                            "country": "BR",
118
                            "details": "Conjunto 15"
119
                        }
120
                    }
121
                },
122
                "delivery": {
123
                    "id": "1569723",
124
                    "type": "normal",
125
                    "scheduled": false,
126
                    "deliverer": {
127
                        "id": "456987",
128
                        "name": "João Entregador"
129
                    }
130
                }
131
            }
132
        ],
133
        "payments": [
134
            {
135
                "id": "974613",
136
                "method": "credit_card",
137
                "payment_value": 110.0,
138
                "installments": 1,
139
                "interest": 0.1,
140
                "document_type": "cpf",
141
                "document": "12345678911",
142
                "credit_card": {
143
                    "first_six_digits": "123456",
144
                    "last_four_digits": "1234",
145
                    "expiration_date": "23/05",
146
                    "holder_name": "Random da Silva"
147
                },
148
                "billing_address": {
149
                    "street_name": "Rua Fidalga",
150
                    "street_number": "252",
151
                    "zip_code": "05432-010",
152
                    "city": "São Paulo",
153
                    "state": "SP",
154
                    "country": "BR"
155
                }
156
            }
157
        ],
158
        "shipping_address": {
159
            "street_name": "Rua Fidalga",
160
            "street_number": "252",
161
            "zip_code": "05432-010",
162
            "city": "São Paulo",
163
            "state": "SP",
164
            "country": "BR",
165
            "details": "Apto 308",
166
            "label": "Home"
167
        }
168
    }'
Copied!
1
import json
2
​
3
import requests
4
​
5
headers = {
6
    'Authorization': 'Bearer $API_KEY',
7
}
8
​
9
data = {
10
    'id': '12345',
11
    'evaluate': true,
12
    'total_paid_value': 110.0,
13
    'total_gross_value': 100.0,
14
    'discount_value': 10.0,
15
    'shipping_value': 10.0,
16
    'tip_value': 5.0,
17
    'coupon_names': ['LOTR'],
18
    'currency': 'BRL',
19
    'status': 'pending',
20
    'creation_datetime': '2020-02-10T20:18:40Z',
21
    'tax_invoice_document_type': 'cpf',
22
    'tax_invoice_document': '12345678911',
23
    'user': {
24
        'id': '98745',
25
        'name':'john fulano',
26
        'email': '[email protected]',
27
        'document': '123.456.789-10',
28
        'document_type': 'cpf',
29
        'phone_number': '11999123456',
30
        'phone_country_code':'55',
31
        'password_hash': 'effebbbeeabc123',
32
        'gender': 'male',
33
        'social_login': 'facebook',
34
        'creation_datetime': '2019-12-17T00:48:03Z',
35
        'address': {
36
            'street_name': 'Rua Fidalga',
37
            'street_number': '252',
38
            'zip_code': '05432-010',
39
            'city': 'São Paulo',
40
            'state': 'SP',
41
            'country': 'BR',
42
            'details': 'Apto 11',
43
            'label': 'Casa'
44
        }
45
    },
46
    'items': [
47
        {
48
            'quantity':2,
49
            'unit_price':30,
50
            'unit_discount':0,
51
            'total_value':60,
52
            'product': {
53
                'sku': '15975368',
54
                'title': 'Product A',
55
                'product_id': '123',
56
                'ean': '1589461449846',
57
                'description': 'Cool Product A',
58
                'categories': ['8'],
59
                'seller': {
60
                    'id': '852456',
61
                    'name': 'Meu Marketplace',
62
                    'description': 'O melhor marketplace de todos',
63
                    'email': '[email protected]',
64
                    'categories': ['9', '45'],
65
                    'subcategories': ['4541', '41546'],
66
                    'document_type': 'cnpj',
67
                    'document': '45.543.948/0001-00',
68
                    'phone_country_code': '+55',
69
                    'phone_number': '1138544649',
70
                    'creation_datetime': '2019-12-17T00:48:03Z',
71
                    'address': {
72
                        'street_name': 'Rua Fidalga',
73
                        'street_number': '252',
74
                        'zip_code': '05432-010',
75
                        'city': 'São Paulo',
76
                        'state': 'SP',
77
                        'country': 'BR',
78
                        'details': 'Conjunto 15'
79
                    }
80
                }
81
            },
82
            'delivery': {
83
                'id': '1569723',
84
                'type': 'normal',
85
                'scheduled': false,
86
                'deliverer': {
87
                    'id': '456987',
88
                    'name': 'João Entregador'
89
                }
90
            }
91
        },
92
        {
93
            'quantity':1,
94
            'unit_price':50.0,
95
            'unit_discount':10.0,
96
            'total_value':40.0,
97
            'product': {
98
                'sku': '75363418',
99
                'title': 'Product B',
100
                'product_id': '456',
101
                'ean': '4194874146871',
102
                'description': 'Cool Product B',
103
                'categories': ['8', '9'],
104
                'seller': {
105
                    'id': '74123',
106
                    'name': 'Meu Marketplace 2',
107
                    'description': 'O segundo melhor marketplace de todos',
108
                    'email': '[email protected]',
109
                    'categories': ['9', '45'],
110
                    'subcategories'