Introdução
Bem vindo a documentação da API Convertize.
Nossa API possui um conjunto de documentos que podem ser ultilizados como base, oferecendo recursos para controlar, integrar seu e-commerce com qualquer sistema, de forma rapida e fácil.
Ambiente Produção:
https://api.convertize.com.br/
{ENVIRONMENT}:
Nome dado para o ambiente do cliente junto a Convertize últlizado em todas as requisições da API
Para executar uma operação, combine a URL base do ambiente com a URL do {ENVIRONMENT} com a URL da operação desejada e envie utilizando o verbo HTTP conforme descrito na operação.
Exemplo: {URL_BASE}/{ENVIRONMENT}/{URL_OPERACAO}
Autenticação
Exemplo de autenticação:
import requests
r = requests . get ( 'api_endpoint_here' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
curl "api_endpoint_here"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "api_endpoint_here" );
var request = new RestRequest ( "request_path" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
Certifique-se de substituir API_KEY
com a sua chave de acesso.
Para obter uma chave de acesso a nossa API envie um email para dev@convertize.com.br .
Nossa API espera uma chave de acesso que deverá ser incluida em todas as solicitações, dentro da HEAD da solicitação conforme abaixo:
Authorization: Token API_KEY
Você deve substituir API_KEY
pela sua chave de acesso.
Paginação
Nossa API trabalha com paginação de objetos, o limite de objetos por requisição é 100 por página, confome modelo ao lado.
Descrição dos parametros de retorno da páginação
Parametro
Descrição
count
Quantidade de páginas
next
Proxima página, null = Última página
previous
Página anterior, null = Primeira página
results
Lista de objetos
{
"count" : 5 ,
"next" : "api_endpoint_here?page=2" ,
"previous" : null ,
"results" : [
]
}
Mensagens
Sucesso
Nossa API usa os códigos de sucesso abaixo:
Error Code
Meaning
Descrição
200
OK
OK
201
Created
Objeto criado
202
Accepted
Requisição aceita
Erros
Nossa API usa os códigos de erros abaixo:
Error Code
Meaning
Descrição
400
Bad Request
Requisição inválida
401
Unauthorized
Chave de API inválida
403
Forbidden
Acesso proibido
404
Not Found
Não econtrado
405
Method Not Allowed
Método não permitido
406
Not Acceptable
Formato da requisição inválido
410
Gone
Esta função foi removida de nossos servidores
418
I’m a teapot
429
Too Many Requests
Você esta fazendo muitas requisições em nossos servidores! Diminua!
500
Internal Server Error
Problemas com nossos servidores. Tente novamente mais tarde.
503
Service Unavailable
Nossos servidores estão passando por manutenção. Tente novamente mais tarde.
Clientes
Lista
Lista de Clientes
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/customers/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/customers/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/" );
var request = new RestRequest ( "/customers/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 40607 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/customers/?page=2" ,
"previous" : null ,
"results" : [
{
"id" : 138468 ,
"reference_code" : null ,
"email" : "contato@convertize.com.br" ,
"name" : "Convertize E-Commerce" ,
"blocked" : false ,
"newsletter" : 1 ,
"zipcode" : null ,
"address" : null ,
"number" : null ,
"neighborhood" : null ,
"complement" : null ,
"city" : null ,
"state" : null ,
"phone1" : null ,
"phone2" : null ,
"reference" : null ,
"city_id" : null ,
"code_ibge" : null ,
"add_date" : "2017-08-18T14:04:04.826000" ,
"change_date" : "2017-08-18T14:04:04.826020" ,
"limit_credit" : null ,
"balance_of_credit" : null
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/1.0/customers/
Filtros via Query Parameters
Parameter
Description
id
ID do cliente
reference_code
Código de referência no ERP
newsletter
Filtro pelo campo newsletter
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
*
Int4
-
ID do cliente
reference_code
Varchar
64
Código de referência do cliente no ERP
email
*
*
Varchar
255
E-mail do cliente
name
Varchar
255
Nome do cliente
blocked
Boolean
1
Indica se esta bloqueado default = false
newsletter
Int4
-
Indica se o cliente quer receber newsletter (1 = SIM, 2 = NÃO, 0 = NÃO)
zipcode
Varchar
9
CEP
address
Varchar
100
Endereço
number
Varchar
100
Número
neighborhood
Varchar
100
Bairro
complement
Varchar
100
Complemento
city
Varchar
100
Cidade
state
Varchar
2
Estado
phone1
Varchar
20
Telefone residencial
phone2
Varchar
20
Telefone celular
reference
Varchar
255
Ponto de Referencia
city_id
Varchar
50
ID da cidade
code_ibge
Varchar
50
Código do IBGE da cidade
limit_credit
Numeric
10,2
Limite de Crédito
balance_of_credit
Numeric
10,2
Saldo de Crédito
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/1.0/customers/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/customers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/customers/{ID}/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/" );
var request = new RestRequest ( "/customers/{ID}/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 138468 ,
"reference_code" : null ,
"email" : "contato@convertize.com.br" ,
"name" : "Convertize E-Commerce" ,
"blocked" : false ,
"newsletter" : 1 ,
"zipcode" : null ,
"address" : null ,
"number" : null ,
"neighborhood" : null ,
"complement" : null ,
"city" : null ,
"state" : null ,
"phone1" : null ,
"phone2" : null ,
"reference" : null ,
"city_id" : null ,
"code_ibge" : null ,
"add_date" : "2017-08-18T14:04:04.826000" ,
"change_date" : "2017-08-18T14:04:04.826020" ,
"limit_credit" : null ,
"balance_of_credit" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao Cliente
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
*
Int4
-
ID do cliente
reference_code
Varchar
64
Código de referência do cliente no ERP
email
*
*
Varchar
255
E-mail do cliente
name
Varchar
255
Nome do cliente
blocked
Boolean
1
Indica se esta bloqueado default = false
newsletter
Int4
-
Indica se o cliente quer receber newsletter (1 = SIM, 2 = NÃO, 0 = NÃO)
zipcode
Varchar
9
CEP
address
Varchar
100
Endereço
number
Varchar
100
Número
neighborhood
Varchar
100
Bairro
complement
Varchar
100
Complemento
city
Varchar
100
Cidade
state
Varchar
2
Estado
phone1
Varchar
20
Telefone residencial
phone2
Varchar
20
Telefone celular
reference
Varchar
255
Ponto de Referencia
city_id
Varchar
50
ID da cidade
code_ibge
Varchar
50
Código do IBGE da cidade
limit_credit
Numeric
10,2
Limite de Crédito
balance_of_credit
Numeric
10,2
Saldo de Crédito
limit_credit
Numeric
10,2
Limite de Crédito
balance_of_credit
Numeric
10,2
Saldo de Crédito
JWT Login
HTTP Request
GET {ENVIRONMENT_DOMAIN}/api/1.0/public/customer.json?jwt={JWT_TOKEN}&app_id={APP_ID}&next=/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/customers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/customers/{ID}/"
-H "Authorization: Token API_KEY"
// Para gerar um JWT Token, você deverá usar as seguintes informações
// payload, app_key e algorithm
// o payload é um objeto contendo algumas informações.
// Login via e-mail:
// payload['email'] = 'suporte@convertize.com.br'
// Login via documento:
// payload['document'] = '07576321000188'
// app_key é gerada pela equipe de suporte da Convertize ou pelo painel do Cliente
// algorithm sempre será o HS256
// Veja com usar em qualquer linguagem de promgramação em: https://jwt.io/
URL Parameters
Parameter
Description
JWT_TOKEN
JWT token gerado conforme documentação ao lado
app_id
ID da applicação, gerada pela equipe de suporte da Convertize ou pelo painel do Cliente
next
URI destino do cliente
Categorias
Lista
Lista de categorias
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/" );
var request = new RestRequest ( "/categories/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 188 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/?page=2" ,
"previous" : null ,
"results" : [
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/4/" ,
"id" : 4 ,
"parent" : null ,
"_order" : 2 ,
"title" : "Borracharia" ,
"slug" : "borracharia" ,
"active" : true ,
"add_date" : "2014-07-24T09:39:34.660080" ,
"change_date" : "2016-10-06T13:13:00.845996" ,
"meta_title" : "Borracharia - Materiais para Borracharia" ,
"meta_description" : "Grande variedade em ferramentas para Borracharia. Compre agora suas ferramentas para Borracharia, aproveite as melhores marcas e modelos que temos para oferecer. Acesse!" ,
"meta_keywords" : "borracharia" ,
"inherit_template" : false ,
"global_code" : null ,
"lft" : 1 ,
"rght" : 36 ,
"tree_id" : 2 ,
"level" : 0
},
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/74/" ,
"id" : 74 ,
"parent" : 4 ,
"_order" : 65 ,
"title" : "Câmara de Ar" ,
"slug" : "borracharia/camara-de-ar" ,
"active" : true ,
"add_date" : "2014-09-11T14:19:23.997496" ,
"change_date" : "2014-12-26T16:38:32.426313" ,
"meta_title" : "" ,
"meta_description" : "" ,
"meta_keywords" : "" ,
"inherit_template" : false ,
"global_code" : null ,
"lft" : 2 ,
"rght" : 3 ,
"tree_id" : 2 ,
"level" : 1
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/1.0/categories/
Filtros via Query Parameters
Parameter
Description
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da categoria
title
*
Varchar
500
Título
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
active
Boolean
1
Indica se esta ativo default = true
parent
Int4
-
ID da categoria pai
meta_title
Varchar
255
Titulo da categoria para SEO
meta_description
Varchar
255
Descrição da categoria para SEO
inherit_template
Boolean
1
Herdar template do pai
meta_keywords
Varchar
255
Keywords da categoria para SEO separadas por “,”
global_code
Varchar
500
Código da categoria Global (Google)
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/1.0/categories/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/{ID}/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/" );
var request = new RestRequest ( "/categories/{ID}/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/74/" ,
"id" : 74 ,
"parent" : 4 ,
"_order" : 65 ,
"title" : "Câmara de Ar" ,
"slug" : "borracharia/camara-de-ar" ,
"active" : true ,
"add_date" : "2014-09-11T14:19:23.997496" ,
"change_date" : "2014-12-26T16:38:32.426313" ,
"meta_title" : "" ,
"meta_description" : "" ,
"meta_keywords" : "" ,
"inherit_template" : false ,
"global_code" : null ,
"lft" : 2 ,
"rght" : 3 ,
"tree_id" : 2 ,
"level" : 1
}
URL Parameters
Parameter
Description
ID
ID relativo a categoria
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da categoria
title
*
Varchar
500
Título
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
active
Boolean
1
Indica se esta ativo default = true
parent
Int4
-
ID da categoria pai
meta_title
Varchar
255
Titulo da categoria para SEO
meta_description
Varchar
255
Descrição da categoria para SEO
inherit_template
Boolean
1
Herdar template do pai
meta_keywords
Varchar
255
Keywords da categoria para SEO separadas por “,”
global_code
Varchar
500
Código da categoria Global (Google)
Criação
HTTP Request
POST /{ENVIRONMENT}/api/1.0/categories/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"title" : "TITULO" ,
"active" : true ,
"meta_title" : "TITULO SEO" ,
"meta_description" : "DESCRICAO SEO" ,
"meta_keywords" : "KEYWORDS SEO" ,
"inherit_template" : false
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/74/" ,
"id" : 74 ,
"parent" : null ,
"_order" : 65 ,
"title" : "TITULO" ,
"slug" : "teste" ,
"active" : true ,
"add_date" : "2014-09-11T14:19:23.997496" ,
"change_date" : "2014-12-26T16:38:32.426313" ,
"meta_title" : "TITULO SEO" ,
"meta_description" : "DESCRICAO SEO" ,
"meta_keywords" : "KEYWORDS SEO" ,
"inherit_template" : false ,
"global_code" : null ,
"lft" : 2 ,
"rght" : 3 ,
"tree_id" : 2 ,
"level" : 1
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da categoria
title
*
Varchar
500
Título
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
active
Boolean
1
Indica se esta ativo default = true
parent
Int4
-
ID da categoria pai
meta_title
Varchar
255
Titulo da categoria para SEO
meta_description
Varchar
255
Descrição da categoria para SEO
inherit_template
Boolean
1
Herdar template do pai
meta_keywords
Varchar
255
Keywords da categoria para SEO separadas por “,”
global_code
Varchar
500
Código da categoria Global (Google)
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/1.0/categories/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/{ID}/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/74/" ,
"id" : 74 ,
"parent" : 4 ,
"_order" : 65 ,
"title" : "TITULO" ,
"slug" : "teste" ,
"active" : true ,
"add_date" : "2014-09-11T14:19:23.997496" ,
"change_date" : "2014-12-26T16:38:32.426313" ,
"meta_title" : "TITULO SEO" ,
"meta_description" : "DESCRICAO SEO" ,
"meta_keywords" : "KEYWORDS SEO" ,
"inherit_template" : false ,
"global_code" : null ,
"lft" : 2 ,
"rght" : 3 ,
"tree_id" : 2 ,
"level" : 1
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/74/" ,
"id" : 74 ,
"parent" : 4 ,
"_order" : 65 ,
"title" : "TITULO" ,
"slug" : "teste" ,
"active" : true ,
"add_date" : "2014-09-11T14:19:23.997496" ,
"change_date" : "2014-12-26T16:38:32.426313" ,
"meta_title" : "TITULO SEO" ,
"meta_description" : "DESCRICAO SEO" ,
"meta_keywords" : "KEYWORDS SEO" ,
"inherit_template" : false ,
"global_code" : null ,
"lft" : 2 ,
"rght" : 3 ,
"tree_id" : 2 ,
"level" : 1
}
URL Parameters
Parameter
Description
ID
ID relativo a categoria
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da categoria
title
*
Varchar
500
Título
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
active
Boolean
1
Indica se esta ativo default = true
parent
Int4
-
ID da categoria pai
meta_title
Varchar
255
Titulo da categoria para SEO
meta_description
Varchar
255
Descrição da categoria para SEO
inherit_template
Boolean
1
Herdar template do pai
meta_keywords
Varchar
255
Keywords da categoria para SEO separadas por “,”
global_code
Varchar
500
Código da categoria Global (Google)
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/1.0/categories/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/1.0/categories/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo a categoria
Marcas
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 135 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/?page=2" ,
"previous" : null ,
"results" : [
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/735/" ,
"id" : 735 ,
"title" : "ACR" ,
"slug" : "acr" ,
"active" : true ,
"description" : "" ,
"keywords" : "" ,
"add_date" : "2014-08-01T16:27:17.913597" ,
"change_date" : "2014-08-01T16:27:17.913621" ,
"image" : null
},
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/784/" ,
"id" : 784 ,
"title" : "ASICS" ,
"slug" : "asics" ,
"active" : true ,
"description" : "" ,
"keywords" : "" ,
"add_date" : "2015-11-11T18:41:45.807927" ,
"change_date" : "2016-02-05T14:23:11.535834" ,
"image" : "https://api.convertize.com.br/{ENVIRONMENT}/products/brands/2016/2_0UfItQF.jpg"
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/1.0/brands/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID da marca
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da marca
title
*
Varchar
500
Titulo
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
active
Boolean
1
Indica se esta ativo default = true
description
Varchar
255
Descrição da marca para SEO
keywords
Varchar
255
Keywords da marca para SEO separadas por “,”
image
Varchar
100
URL da imagem
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/1.0/brands/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/784/" ,
"id" : 784 ,
"title" : "ASICS" ,
"slug" : "asics" ,
"active" : true ,
"description" : "" ,
"keywords" : "" ,
"add_date" : "2015-11-11T18:41:45.807927" ,
"change_date" : "2016-02-05T14:23:11.535834" ,
"image" : "https://api.convertize.com.br/{ENVIRONMENT}/products/brands/2016/2_0UfItQF.jpg"
}
URL Parameters
Parameter
Description
ID
ID relativo a marca
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da marca
title
*
Varchar
500
Titulo
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
active
Boolean
1
Indica se esta ativo default = true
description
Varchar
255
Descrição da marca para SEO
keywords
Varchar
255
Keywords da marca para SEO separadas por “,”
image
Varchar
100
URL da imagem
Criação
HTTP Request
POST /{ENVIRONMENT}/api/1.0/brands/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
}, files = {
'image' : open ( 'CAMINHO_LOCAL_DO_ARQUIVO' , 'rb' ),
}, data = {
'title' : 'TESTE' ,
'active' : 'true'
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/"
-H "Authorization: Token API_KEY"
-H "Content-Type: multipart/form-data"
-X POST
-F "title=TESTE"
-F "active=true"
-F "image=@CAMINHO_LOCAL_DO_ARQUIVO"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/790/" ,
"id" : 790 ,
"title" : "TESTE" ,
"slug" : "teste" ,
"active" : true ,
"description" : null ,
"keywords" : null ,
"add_date" : "2016-10-07T19:06:06.076498" ,
"change_date" : "2016-10-07T19:06:06.076534" ,
"image" : "https://api.convertize.com.br/{ENVIRONMENT}/products/brands/2016/logo.png"
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da marca
title
*
Varchar
500
Titulo
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
active
Boolean
1
Indica se esta ativo default = true
description
Varchar
255
Descrição da marca para SEO
keywords
Varchar
255
Keywords da marca para SEO separadas por “,”
image
Varchar
100
URL da imagem
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/1.0/brands/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
}, files = {
'image' : open ( 'CAMINHO_LOCAL_DO_ARQUIVO' , 'rb' ),
}, data = {
'title' : 'TESTE' ,
'active' : 'true'
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: multipart/form-data"
-X PUT
-F "title=TESTE"
-F "active=true"
-F "image=@CAMINHO_LOCAL_DO_ARQUIVO"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/790/" ,
"id" : 790 ,
"title" : "TESTE" ,
"slug" : "teste" ,
"active" : true ,
"description" : null ,
"keywords" : null ,
"add_date" : "2016-10-07T19:06:06.076498" ,
"change_date" : "2016-10-07T19:06:06.076534" ,
"image" : "https://api.convertize.com.br/{ENVIRONMENT}/products/brands/2016/logo.png"
}
URL Parameters
Parameter
Description
ID
ID relativo a marca
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da marca
title
*
Varchar
500
Titulo
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
active
Boolean
1
Indica se esta ativo default = true
description
Varchar
255
Descrição da marca para SEO
keywords
Varchar
255
Keywords da marca para SEO separadas por “,”
image
Varchar
100
URL da imagem
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/1.0/brands/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/brands/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/1.0/brands/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo a marca
Grade
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 41 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/?page=2" ,
"previous" : null ,
"results" : [
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/1/" ,
"id" : 1 ,
"title" : "Esmerilhadeiras" ,
"display" : "radio" ,
"reference_code" : null ,
"add_date" : "2014-07-24T09:44:23.173981" ,
"change_date" : "2014-07-24T09:53:45.519836"
},
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/2/" ,
"id" : 2 ,
"title" : "Trenas" ,
"display" : "radio" ,
"reference_code" : null ,
"add_date" : "2014-07-31T10:14:19.039051" ,
"change_date" : "2014-07-31T10:14:41.881381"
}
]
}
HTTP Request
GET {ENVIRONMENT}/api/1.0/grids/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID do produto
reference_code
Código de referência ou código da grade no ERP
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da grade
title
*
Varchar
500
Titulo
display
Varchar
50
Forma de display opções (radio, select, custom)
active
Boolean
1
Indica se esta ativo default = true
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Detalhes
HTTP Request
GET {ENVIRONMENT}/api/1.0/grids/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/2/" ,
"id" : 2 ,
"title" : "Trenas" ,
"display" : "radio" ,
"reference_code" : null ,
"add_date" : "2014-07-31T10:14:19.039051" ,
"change_date" : "2014-07-31T10:14:41.881381"
}
URL Parameters
Parameter
Description
ID
ID relativo a grade
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da grade
title
*
Varchar
500
Titulo
display
Varchar
50
Forma de display opções (radio, select, custom)
active
Boolean
1
Indica se esta ativo default = true
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Criação
HTTP Request
POST {ENVIRONMENT}/api/1.0/grids/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"title" : "TITULO" ,
"display" : "radio"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/2/" ,
"id" : 2 ,
"title" : "Trenas" ,
"display" : "radio" ,
"reference_code" : null ,
"add_date" : "2014-07-31T10:14:19.039051" ,
"change_date" : "2014-07-31T10:14:41.881381"
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da grade
title
*
Varchar
500
Titulo
display
Varchar
50
Forma de display opções (radio, select, custom)
active
Boolean
1
Indica se esta ativo default = true
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Alteração
HTTP Request
PUT {ENVIRONMENT}/api/1.0/grids/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"title" : "Trenas" ,
"display" : "radio"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/grids/2/" ,
"id" : 2 ,
"title" : "Trenas" ,
"display" : "radio" ,
"reference_code" : null ,
"add_date" : "2014-07-31T10:14:19.039051" ,
"change_date" : "2014-07-31T10:14:41.881381"
}
URL Parameters
Parameter
Description
ID
ID relativo a grade
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da grade
title
*
Varchar
500
Titulo
display
Varchar
50
Forma de display opções (radio, select, custom)
active
Boolean
1
Indica se esta ativo default = true
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Grade - Opções
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 6 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/?page=2" ,
"previous" : null ,
"results" : [
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/5/" ,
"id" : 5 ,
"grid" : 43 ,
"position" : 0 ,
"title" : "Cor" ,
"slug" : "cor" ,
"filterable" : false ,
"ungroup" : false ,
"display" : null ,
"reference_code" : null ,
"add_date" : "2015-11-11T18:06:14.024972" ,
"change_date" : "2015-11-11T18:06:14.024989"
},
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/2/" ,
"id" : 2 ,
"grid" : 5 ,
"position" : 0 ,
"title" : "Tamanho" ,
"slug" : "tamanho" ,
"filterable" : false ,
"ungroup" : false ,
"display" : null ,
"reference_code" : null ,
"add_date" : "2014-08-18T16:58:42.012403" ,
"change_date" : "2014-08-18T17:03:43.902259"
}
]
}
HTTP Request
GET {ENVIRONMENT}/api/1.0/options/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID da opção
reference_code
Código de referência ou código da grade no ERP
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da opcao
grid
*
Int4
-
ID da Grade
position
Int2
-
Ordem das opções
title
*
Varchar
500
Titulo
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
filterable
Boolean
1
Define se a opção será filtravel (default = true)
ungroup
Boolean
1
Define se a opção deverá ser desagrupada (default = false)
display
Varchar
50
Forma de display opções (checkbox, color, size)
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Detalhes
HTTP Request
GET {ENVIRONMENT}/api/1.0/options/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/2/" ,
"id" : 2 ,
"grid" : 5 ,
"position" : 0 ,
"title" : "Tamanho" ,
"slug" : "tamanho" ,
"filterable" : false ,
"ungroup" : false ,
"display" : null ,
"reference_code" : null ,
"add_date" : "2014-08-18T16:58:42.012403" ,
"change_date" : "2014-08-18T17:03:43.902259"
}
URL Parameters
Parameter
Description
ID
ID relativo a opção
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da opcao
grid
*
Int4
-
ID da Grade
position
Int2
-
Ordem das opções
title
*
Varchar
500
Titulo
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
filterable
Boolean
1
Define se a opção será filtravel (default = true)
ungroup
Boolean
1
Define se a opção deverá ser desagrupada (default = false)
display
Varchar
50
Forma de display opções (checkbox, color, size)
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Criação
HTTP Request
POST {ENVIRONMENT}/api/1.0/options/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"title" : "Tamanho" ,
"filterable" : false ,
"ungroup" : false ,
"grid" : 5
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/2/" ,
"id" : 2 ,
"grid" : 5 ,
"position" : 0 ,
"title" : "Tamanho" ,
"slug" : "tamanho" ,
"filterable" : false ,
"ungroup" : false ,
"display" : null ,
"reference_code" : null ,
"add_date" : "2014-08-18T16:58:42.012403" ,
"change_date" : "2014-08-18T17:03:43.902259"
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da opcao
grid
*
Int4
-
ID da Grade
position
Int2
-
Ordem das opções
title
*
Varchar
500
Titulo
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
filterable
Boolean
1
Define se a opção será filtravel (default = true)
ungroup
Boolean
1
Define se a opção deverá ser desagrupada (default = false)
display
Varchar
50
Forma de display opções (checkbox, color, size)
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Alteração
HTTP Request
PUT {ENVIRONMENT}/api/1.0/options/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"title" : "Tamanho" ,
"filterable" : false ,
"ungroup" : false ,
"grid" : 5
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/options/2/" ,
"id" : 2 ,
"grid" : 5 ,
"position" : 0 ,
"title" : "Tamanho" ,
"slug" : "tamanho" ,
"filterable" : false ,
"ungroup" : false ,
"display" : null ,
"reference_code" : null ,
"add_date" : "2014-08-18T16:58:42.012403" ,
"change_date" : "2014-08-18T17:03:43.902259"
}
URL Parameters
Parameter
Description
ID
ID relativo a opção
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da opcao
grid
*
Int4
-
ID da Grade
position
Int2
-
Ordem das opções
title
*
Varchar
500
Titulo
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
filterable
Boolean
1
Define se a opção será filtravel (default = true)
ungroup
Boolean
1
Define se a opção deverá ser desagrupada (default = false)
display
Varchar
50
Forma de display opções (checkbox, color, size)
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Grade - Valores
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 20 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/?page=2" ,
"previous" : null ,
"results" : [
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/14/" ,
"id" : 14 ,
"option" : 5 ,
"position" : 0 ,
"value" : "Azul" ,
"color" : "" ,
"reference_code" : null ,
"add_date" : "2015-11-11T18:06:14.383121" ,
"change_date" : "2015-11-11T18:38:46.746944"
},
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/15/" ,
"id" : 15 ,
"option" : 5 ,
"position" : 1 ,
"value" : "Limão" ,
"color" : "" ,
"reference_code" : null ,
"add_date" : "2015-11-11T18:06:14.465148" ,
"change_date" : "2015-11-11T18:38:46.764939"
}
]
}
HTTP Request
GET {ENVIRONMENT}/api/1.0/values/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID do valor
reference_code
Código de referência ou código da grade no ERP
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do valor
option
*
Int4
-
ID da opção
position
Int2
-
Ordem dos valores
value
*
Varchar
500
Titulo
color
Varchar
255
#Hexadecimal - (separar por virgula caso haja mais de uma)
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Detalhes
HTTP Request
GET {ENVIRONMENT}/api/1.0/values/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/15/" ,
"id" : 15 ,
"option" : 5 ,
"position" : 1 ,
"value" : "Limão" ,
"color" : "" ,
"reference_code" : null ,
"add_date" : "2015-11-11T18:06:14.465148" ,
"change_date" : "2015-11-11T18:38:46.764939"
}
URL Parameters
Parameter
Description
ID
ID relativo ao valor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do valor
option
*
Int4
-
ID da opção
position
Int2
-
Ordem dos valores
value
*
Varchar
500
Titulo
color
Varchar
255
#Hexadecimal - (separar por virgula caso haja mais de uma)
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Criação
HTTP Request
POST {ENVIRONMENT}/api/1.0/values/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"value" : "Azul" ,
"option" : 5
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/14/" ,
"id" : 14 ,
"option" : 5 ,
"position" : 0 ,
"value" : "Azul" ,
"color" : "" ,
"reference_code" : null ,
"add_date" : "2015-11-11T18:06:14.383121" ,
"change_date" : "2015-11-11T18:38:46.746944"
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do valor
option
*
Int4
-
ID da opção
position
Int2
-
Ordem dos valores
value
*
Varchar
500
Titulo
color
Varchar
255
#Hexadecimal - (separar por virgula caso haja mais de uma)
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Alteração
HTTP Request
PUT {ENVIRONMENT}/api/1.0/values/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"value" : "Azul" ,
"option" : 5
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/values/14/" ,
"id" : 14 ,
"option" : 5 ,
"position" : 0 ,
"value" : "Azul" ,
"color" : "" ,
"reference_code" : null ,
"add_date" : "2015-11-11T18:06:14.383121" ,
"change_date" : "2015-11-11T18:38:46.746944"
}
URL Parameters
Parameter
Description
ID
ID relativo ao valor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do valor
option
*
Int4
-
ID da opção
position
Int2
-
Ordem dos valores
value
*
Varchar
500
Titulo
color
Varchar
255
#Hexadecimal - (separar por virgula caso haja mais de uma)
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Grade - Especificações
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 5 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/?page=2" ,
"previous" : null ,
"results" : [
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/4/" ,
"id" : 4 ,
"grid" : 8 ,
"title" : "Encaixe" ,
"filterable" : true ,
"required" : false ,
"position" : 0 ,
"add_date" : "2014-08-26T19:00:31.335595" ,
"change_date" : "2014-12-09T20:23:21.908761"
},
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/2/" ,
"id" : 2 ,
"grid" : 1 ,
"title" : "Rotação" ,
"filterable" : true ,
"required" : false ,
"position" : 0 ,
"add_date" : "2014-07-24T09:53:45.523049" ,
"change_date" : "2014-07-24T09:53:45.523070"
}
]
}
HTTP Request
GET {ENVIRONMENT}/api/1.0/specifications/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID da especificação
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da especificação
grid
*
Int4
-
Código da grade
title
*
Varchar
500
Titulo
filterable
Boolean
1
Define se a opção será filtravel (default = true)
required
Boolean
1
Define se a opção sera requerida (default = false)
position
Int2
-
Ordem das especificações
Detalhes
HTTP Request
GET {ENVIRONMENT}/api/1.0/specifications/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/2/" ,
"id" : 2 ,
"grid" : 1 ,
"title" : "Rotação" ,
"filterable" : true ,
"required" : false ,
"position" : 0 ,
"add_date" : "2014-07-24T09:53:45.523049" ,
"change_date" : "2014-07-24T09:53:45.523070"
}
URL Parameters
Parameter
Description
ID
ID relativo a especificação
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da especificação
grid
*
Int4
-
Código da grade
title
*
Varchar
500
Titulo
filterable
Boolean
1
Define se a opção será filtravel (default = true)
required
Boolean
1
Define se a opção sera requerida (default = false)
position
Int2
-
Ordem das especificações
Criação
HTTP Request
POST {ENVIRONMENT}/api/1.0/specifications/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"grid" : 1 ,
"title" : "Rotação"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/2/" ,
"id" : 2 ,
"grid" : 1 ,
"title" : "Rotação" ,
"filterable" : true ,
"required" : false ,
"position" : 0 ,
"add_date" : "2014-07-24T09:53:45.523049" ,
"change_date" : "2014-07-24T09:53:45.523070"
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da especificação
grid
*
Int4
-
Código da grade
title
*
Varchar
500
Titulo
filterable
Boolean
1
Define se a opção será filtravel (default = true)
required
Boolean
1
Define se a opção sera requerida (default = false)
position
Int2
-
Ordem das especificações
Alteração
HTTP Request
PUT {ENVIRONMENT}/api/1.0/specifications/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"grid" : 1 ,
"title" : "Rotação"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/specifications/2/" ,
"id" : 2 ,
"grid" : 1 ,
"title" : "Rotação" ,
"filterable" : true ,
"required" : false ,
"position" : 0 ,
"add_date" : "2014-07-24T09:53:45.523049" ,
"change_date" : "2014-07-24T09:53:45.523070"
}
URL Parameters
Parameter
Description
ID
ID relativo a especificação
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da especificação
grid
*
Int4
-
Código da grade
title
*
Varchar
500
Titulo
filterable
Boolean
1
Define se a opção será filtravel (default = true)
required
Boolean
1
Define se a opção sera requerida (default = false)
position
Int2
-
Ordem das especificações
Produtos
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do produto
category
Int4
-
ID da categoria
similar_category
Array(Int4)
-
ID`s das categorias similares
brand
Int4
-
ID da marca
grid
Int4
-
ID da grade
suggestions
Array(Int4)
-
ID`s dos produtos como sugestão
similars
Array(Int4)
-
ID`s dos produtos similares
accessories
Array(Int4)
-
ID`s dos produtos como acessórios
title
*
Varchar
255
Titulo do produto para SEO
slug
*
Varchar
2000
Slug (url), caso vazio o sistema gera automaticamente
meta_title
Varchar
255
Titulo da categoria para SEO
description
Varchar
255
Descrição da categoria para SEO
keywords
Varchar
255
Keywords da categoria para SEO separadas por “,”
name
Varchar
500
Nome do produto no ERP
upc
*
Varchar
64
Código de código UPC ou SKU
fiscal_code
Varchar
64
Código classificação fiscal
reference_code
Varchar
64
Código de referência ou código da grade no ERP
available
Boolean
1
Indica se o produto esta disponivel para venda default = false
status
Int2
-
Satus do produto (1 = Rascunho, 2 = Publicado) default = 1
details
Text
-
Detalhes do produto em HTML
Lista
Lista de Produtos
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 1606 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/?page=2" ,
"previous" : null ,
"results" : [
{
"id" : 1053 ,
"category" : 36 ,
"similar_category" : [],
"brand" : 645 ,
"grid" : null ,
"suggestions" : [
1232 ,
1242 ,
1235 ,
1236 ,
1237
],
"similars" : [
1064 ,
1057 ,
1058 ,
1067 ,
1068
],
"accessories" : [],
"title" : "Jogo de Chave Hexagonal 1/16\" a 1/2\" - 12 pçs - BELZER" ,
"slug" : "jogo-de-chave-hexagonal-1-16-a-1-2-12-pcs-belzer-1591" ,
"description" : "" ,
"keywords" : "chave allen,allen" ,
"add_date" : "2014-08-05T17:34:42.471833" ,
"change_date" : "2014-12-04T15:56:04.418662" ,
"name" : "Jogo de Chave Hexagonal 1/16 pol a 1/2 pol - 12 Peças - Ref: 220904 - BELZER" ,
"upc" : "1591" ,
"fiscal_code" : "" ,
"reference_code" : "" ,
"available" : true ,
"status" : 2 ,
"details" : "<p><span style=\"font-size:16px;\"><span style=\"font-family:arial,helvetica,sans-serif;\"><strong>Jogo de Chave Hexagonal.</strong></span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Pasta plástica;</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Jogo composto por 12 peças, sendo:</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">- 1/16" - 5/64" - 3/32" - 1/8" - 5/32" - 3/16" - 7/32" - 1/4" - 5/16" - 3/8" - 7/16 - 1/2".</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Ref: 220904.</span></span></p>\r\n\r\n<p> </p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Marca: BELZER</span></span></p>\r\n"
},
{
"id" : 1196 ,
"category" : 21 ,
"similar_category" : [],
"brand" : 690 ,
"grid" : null ,
"suggestions" : [
1144 ,
1147 ,
1148 ,
1143
],
"similars" : [
1193 ,
1163 ,
1164 ,
1165
],
"accessories" : [],
"title" : "Chave de Fenda 1/4x5 pol - LOYAL" ,
"slug" : "chave-de-fenda-14x5-pol-loyal" ,
"description" : "" ,
"keywords" : "" ,
"add_date" : "2014-09-13T08:42:33.150479" ,
"change_date" : "2014-09-13T09:05:50.237882" ,
"name" : "Chave de Fenda 1/4x5 pol - LOYAL" ,
"upc" : "000730" ,
"fiscal_code" : "" ,
"reference_code" : "" ,
"available" : true ,
"status" : 2 ,
"details" : "<p>Chave Fenda loyal em aço carbono.<br />\r\nCabo em polipropileno.</p>\r\n"
}
]
}
HTTP Request
GET {ENVIRONMENT}/api/1.0/products/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID do produto
reference_code
Código de referência ou código da grade no ERP
upc
Código de código UPC ou SKU
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Detalhes
HTTP Request
GET {ENVIRONMENT}/api/1.0/products/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1053 ,
"category" : 36 ,
"similar_category" : [],
"brand" : 645 ,
"grid" : null ,
"suggestions" : [
1232 ,
1242 ,
1235 ,
1236 ,
1237
],
"similars" : [
1064 ,
1057 ,
1058 ,
1067 ,
1068
],
"accessories" : [],
"title" : "Jogo de Chave Hexagonal 1/16\" a 1/2\" - 12 pçs - BELZER" ,
"slug" : "jogo-de-chave-hexagonal-1-16-a-1-2-12-pcs-belzer-1591" ,
"description" : "" ,
"keywords" : "chave allen,allen" ,
"add_date" : "2014-08-05T17:34:42.471833" ,
"change_date" : "2014-12-04T15:56:04.418662" ,
"name" : "Jogo de Chave Hexagonal 1/16 pol a 1/2 pol - 12 Peças - Ref: 220904 - BELZER" ,
"upc" : "1591" ,
"fiscal_code" : "" ,
"reference_code" : "" ,
"available" : true ,
"status" : 2 ,
"details" : "<p><span style=\"font-size:16px;\"><span style=\"font-family:arial,helvetica,sans-serif;\"><strong>Jogo de Chave Hexagonal.</strong></span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Pasta plástica;</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Jogo composto por 12 peças, sendo:</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">- 1/16" - 5/64" - 3/32" - 1/8" - 5/32" - 3/16" - 7/32" - 1/4" - 5/16" - 3/8" - 7/16 - 1/2".</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Ref: 220904.</span></span></p>\r\n\r\n<p> </p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Marca: BELZER</span></span></p>\r\n"
}
URL Parameters
Parameter
Description
ID
ID relativo ao produto
Criação
HTTP Request
POST {ENVIRONMENT}/api/1.0/products/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"id" : 1053 ,
"category" : 36 ,
"similar_category" : [],
"brand" : 645 ,
"suggestions" : [
1232 ,
1242 ,
1235 ,
1236 ,
1237
],
"similars" : [
1064 ,
1057 ,
1058 ,
1067 ,
1068
],
"title" : "Jogo de Chave Hexagonal 1/16\" a 1/2\" - 12 pçs - BELZER" ,
"slug" : "jogo-de-chave-hexagonal-1-16-a-1-2-12-pcs-belzer-1591" ,
"keywords" : "chave allen,allen" ,
"add_date" : "2014-08-05T17:34:42.471833" ,
"change_date" : "2014-12-04T15:56:04.418662" ,
"name" : "Jogo de Chave Hexagonal 1/16 pol a 1/2 pol - 12 Peças - Ref: 220904 - BELZER" ,
"upc" : "1591" ,
"available" : true ,
"status" : 2 ,
"details" : "<p><span style=\"font-size:16px;\"><span style=\"font-family:arial,helvetica,sans-serif;\"><strong>Jogo de Chave Hexagonal.</strong></span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Pasta plástica;</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Jogo composto por 12 peças, sendo:</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">- 1/16" - 5/64" - 3/32" - 1/8" - 5/32" - 3/16" - 7/32" - 1/4" - 5/16" - 3/8" - 7/16 - 1/2".</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Ref: 220904.</span></span></p>\r\n\r\n<p> </p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Marca: BELZER</span></span></p>\r\n"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1053 ,
"category" : 36 ,
"similar_category" : [],
"brand" : 645 ,
"grid" : null ,
"suggestions" : [
1232 ,
1242 ,
1235 ,
1236 ,
1237
],
"similars" : [
1064 ,
1057 ,
1058 ,
1067 ,
1068
],
"accessories" : [],
"title" : "Jogo de Chave Hexagonal 1/16\" a 1/2\" - 12 pçs - BELZER" ,
"slug" : "jogo-de-chave-hexagonal-1-16-a-1-2-12-pcs-belzer-1591" ,
"description" : "" ,
"keywords" : "chave allen,allen" ,
"add_date" : "2014-08-05T17:34:42.471833" ,
"change_date" : "2014-12-04T15:56:04.418662" ,
"name" : "Jogo de Chave Hexagonal 1/16 pol a 1/2 pol - 12 Peças - Ref: 220904 - BELZER" ,
"upc" : "1591" ,
"fiscal_code" : "" ,
"reference_code" : "" ,
"available" : true ,
"status" : 2 ,
"details" : "<p><span style=\"font-size:16px;\"><span style=\"font-family:arial,helvetica,sans-serif;\"><strong>Jogo de Chave Hexagonal.</strong></span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Pasta plástica;</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Jogo composto por 12 peças, sendo:</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">- 1/16" - 5/64" - 3/32" - 1/8" - 5/32" - 3/16" - 7/32" - 1/4" - 5/16" - 3/8" - 7/16 - 1/2".</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Ref: 220904.</span></span></p>\r\n\r\n<p> </p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Marca: BELZER</span></span></p>\r\n"
}
Alteração
HTTP Request
PUT {ENVIRONMENT}/api/1.0/products/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"category" : 36 ,
"similar_category" : [],
"brand" : 645 ,
"suggestions" : [
1232 ,
1242 ,
1235 ,
1236 ,
1237
],
"similars" : [
1064 ,
1057 ,
1058 ,
1067 ,
1068
],
"title" : "Jogo de Chave Hexagonal 1/16\" a 1/2\" - 12 pçs - BELZER" ,
"slug" : "jogo-de-chave-hexagonal-1-16-a-1-2-12-pcs-belzer-1591" ,
"keywords" : "chave allen,allen" ,
"add_date" : "2014-08-05T17:34:42.471833" ,
"change_date" : "2014-12-04T15:56:04.418662" ,
"name" : "Jogo de Chave Hexagonal 1/16 pol a 1/2 pol - 12 Peças - Ref: 220904 - BELZER" ,
"upc" : "1591" ,
"available" : true ,
"status" : 2 ,
"details" : "<p><span style=\"font-size:16px;\"><span style=\"font-family:arial,helvetica,sans-serif;\"><strong>Jogo de Chave Hexagonal.</strong></span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Pasta plástica;</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Jogo composto por 12 peças, sendo:</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">- 1/16" - 5/64" - 3/32" - 1/8" - 5/32" - 3/16" - 7/32" - 1/4" - 5/16" - 3/8" - 7/16 - 1/2".</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Ref: 220904.</span></span></p>\r\n\r\n<p> </p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Marca: BELZER</span></span></p>\r\n"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1053 ,
"category" : 36 ,
"similar_category" : [],
"brand" : 645 ,
"grid" : null ,
"suggestions" : [
1232 ,
1242 ,
1235 ,
1236 ,
1237
],
"similars" : [
1064 ,
1057 ,
1058 ,
1067 ,
1068
],
"accessories" : [],
"title" : "Jogo de Chave Hexagonal 1/16\" a 1/2\" - 12 pçs - BELZER" ,
"slug" : "jogo-de-chave-hexagonal-1-16-a-1-2-12-pcs-belzer-1591" ,
"description" : "" ,
"keywords" : "chave allen,allen" ,
"add_date" : "2014-08-05T17:34:42.471833" ,
"change_date" : "2014-12-04T15:56:04.418662" ,
"name" : "Jogo de Chave Hexagonal 1/16 pol a 1/2 pol - 12 Peças - Ref: 220904 - BELZER" ,
"upc" : "1591" ,
"fiscal_code" : "" ,
"reference_code" : "" ,
"available" : true ,
"status" : 2 ,
"details" : "<p><span style=\"font-size:16px;\"><span style=\"font-family:arial,helvetica,sans-serif;\"><strong>Jogo de Chave Hexagonal.</strong></span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Pasta plástica;</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Jogo composto por 12 peças, sendo:</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">- 1/16" - 5/64" - 3/32" - 1/8" - 5/32" - 3/16" - 7/32" - 1/4" - 5/16" - 3/8" - 7/16 - 1/2".</span></span></p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Ref: 220904.</span></span></p>\r\n\r\n<p> </p>\r\n\r\n<p><span style=\"font-size:14px;\"><span style=\"font-family:arial,helvetica,sans-serif;\">Marca: BELZER</span></span></p>\r\n"
}
URL Parameters
Parameter
Description
ID
ID relativo a categoria
Produto - Especificações
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/specifications' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/specifications"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 1845 ,
"next" : "https://api.convertize.com.br/emporiodaporcelana/api/1.0/products/specifications/?page=2" ,
"previous" : null ,
"results" : [
{
"url" : "/api/1.0/products/specifications/220/" ,
"id" : 220 ,
"product" : 92 ,
"specification" : 2 ,
"value" : "Waves" ,
"value_as_float" : null ,
"add_date" : "2018-10-27T12:54:12.531948" ,
"change_date" : "2018-10-27T12:54:37.644119"
},
{
"url" : "/api/1.0/products/specifications/250/" ,
"id" : 250 ,
"product" : 446 ,
"specification" : 2 ,
"value" : "Colibri" ,
"value_as_float" : null ,
"add_date" : "2018-11-02T13:41:10.200595" ,
"change_date" : "2018-11-02T13:42:23.529897"
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/1.0/products/specifications/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID do valor da especificação
product
Filtro pelo ID do produto
specification
Filtro pelo ID da especificação
value
Filtro pelo Valor da especificação
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do valor da especificação
specification
*
Int4
-
Código da grade
product
*
Int4
-
Código do produto
value
*
Varchar
500
Valor
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/1.0/products/specifications/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/specifications/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/specifications/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 250 ,
"product" : 446 ,
"specification" : 2 ,
"value" : "Colibri" ,
"value_as_float" : null ,
"add_date" : "2018-11-02T13:41:10.200595" ,
"change_date" : "2018-11-02T13:42:23.529897"
}
URL Parameters
Parameter
Description
ID
ID relativo a especificação
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do valor da especificação
specification
*
Int4
-
Código da grade
product
*
Int4
-
Código do produto
value
*
Varchar
500
Valor
Criação
HTTP Request
POST /{ENVIRONMENT}/api/1.0/products/specifications/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/specifications/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/specifications/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"product" : 446 ,
"specification" : 2 ,
"value" : "Colibri"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 250 ,
"product" : 446 ,
"specification" : 2 ,
"value" : "Colibri" ,
"value_as_float" : null ,
"add_date" : "2018-11-02T13:41:10.200595" ,
"change_date" : "2018-11-02T13:42:23.529897"
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do valor da especificação
specification
*
Int4
-
Código da grade
product
*
Int4
-
Código do produto
value
*
Varchar
500
Valor
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/1.0/products/specifications/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/specifications/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/products/specifications/{ID}/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"product" : 446 ,
"specification" : 2 ,
"value" : "Colibri"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 250 ,
"product" : 446 ,
"specification" : 2 ,
"value" : "Colibri" ,
"value_as_float" : null ,
"add_date" : "2018-11-02T13:41:10.200595" ,
"change_date" : "2018-11-02T13:42:23.529897"
}
URL Parameters
Parameter
Description
ID
ID relativo a especificação
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do valor da especificação
specification
*
Int4
-
Código da grade
product
*
Int4
-
Código do produto
value
*
Varchar
500
Valor
Produto - Imagens
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/images/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/images"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 18 ,
"next" : null ,
"previous" : null ,
"results" : [
{
"id" : 645 ,
"position" : 1 ,
"title" : "" ,
"image" : "https://io.convertiez.com.br/m/apisandbox/shop/products/images/2020562/roupao-microfibra-home-design-p-rosa-antigo-100-poliester-corttex_ff794107-e505-4677-8619-a360c99c1cd4.jpg" ,
"video" : "" ,
"add_date" : "2019-07-23T13:44:27.935202" ,
"change_date" : "2019-07-23T13:44:27.935266" ,
"product" : 2020562 ,
"skus" : []
},
{
"id" : 646 ,
"position" : 1 ,
"title" : "" ,
"image" : "https://io.convertiez.com.br/m/apisandbox/shop/products/images/2020563/roupao-microfibra-home-design-g-rosa-antigo-100-poliester-corttex_c682cdde-866f-4247-985e-aa817677688a.jpg" ,
"video" : "" ,
"add_date" : "2019-07-23T13:45:56.633235" ,
"change_date" : "2019-07-23T13:45:56.633265" ,
"product" : 2020563 ,
"skus" : []
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/1.0/images/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID do valor da imagem
product_id
Filtro pelo ID do produto
title__icontains
Filtro pelo Título da foto
title__isnull
Filtro pelo Título quando vazio
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da Imagem
position
*
Int4
-
Posição
product
*
Int4
-
ID do Produto
title
Varchar
150
Titulo
image
*
Varchar
-
URL da Imagem
video
Varchar
-
Video
skus
list
-
Lista de SKUs vinculados a imagem
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/1.0/images/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/images/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/images/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 646 ,
"position" : 1 ,
"title" : "" ,
"image" : "https://io.convertiez.com.br/m/apisandbox/shop/products/images/2020563/roupao-microfibra-home-design-g-rosa-antigo-100-poliester-corttex_c682cdde-866f-4247-985e-aa817677688a.jpg" ,
"video" : "" ,
"add_date" : "2019-07-23T13:45:56.633235" ,
"change_date" : "2019-07-23T13:45:56.633265" ,
"product" : 2020563 ,
"skus" : []
}
URL Parameters
Parameter
Description
ID
ID relativo a imagem
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da Imagem
position
*
Int4
-
Posição
product
*
Int4
-
ID do Produto
title
Varchar
150
Titulo
image
*
Varchar
-
URL da Imagem
video
Varchar
-
Video
skus
list
-
Lista de SKUs vinculados a imagem
Criação
HTTP Request
POST /{ENVIRONMENT}/api/1.0/images/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/images/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/x-www-form-urlencoded'
}, data =< PARAMETROS > , files = {
"image" : open ( path , 'rb' )
})
print r . status_code
print r . json ()
curl -X POST \
https://api.convertize.com.br/{ ENVIRONMENT} /api/1.0/images/ \
-H 'Authorization: Token API_KEY' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-F position = 2 \
-F product = 2020562 \
-F image = @/Users/convertize/Downloads/89898E92-7747-4E0B-8564-6126D527C9D3.JPG
Exemplo < PARAMETROS > a ser enviado:
position=2
product=2020562
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 668 ,
"position" : 2 ,
"title" : null ,
"image" : "https://io.convertiez.com.br/m/apisandbox/shop/products/images/2020562/roupao-microfibra-home-design-p-rosa-antigo-100-poliester-corttex_6ab1d9a2-61d5-4cc2-8468-a090db3ad217.JPG" ,
"video" : null ,
"add_date" : "2019-10-04T16:29:22.079009" ,
"change_date" : "2019-10-04T16:29:22.079040" ,
"product" : 2020562 ,
"skus" : []
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da Imagem
position
*
Int4
-
Posição
product
*
Int4
-
ID do Produto
title
Varchar
150
Titulo
image
*
Varchar
-
URL da Imagem
video
Varchar
-
Video
skus
list
-
Lista de SKUs vinculados a imagem
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/1.0/images/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/images/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/x-www-form-urlencoded'
}, data =< PARAMETROS > , files = {
"image" : open ( path , 'rb' )
})
print r . status_code
print r . json ()
curl -X PUT \
https://api.convertize.com.br/{ ENVIRONMENT} /api/1.0/images/{ ID} / \
-H 'Authorization: Token API_KEY' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-F position = 2 \
-F product = 2020562 \
-F image = @/Users/convertize/Downloads/89898E92-7747-4E0B-8564-6126D527C9D3.JPG
Exemplo < PARAMETROS > a ser enviado:
position=2
product=2020562
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 668 ,
"position" : 2 ,
"title" : null ,
"image" : "https://io.convertiez.com.br/m/apisandbox/shop/products/images/2020562/roupao-microfibra-home-design-p-rosa-antigo-100-poliester-corttex_668.JPG" ,
"video" : null ,
"add_date" : "2019-10-04T16:29:22.079009" ,
"change_date" : "2019-10-04T16:34:10.487435" ,
"product" : 2020562 ,
"skus" : []
}
URL Parameters
Parameter
Description
ID
ID relativo a imagem
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da Imagem
position
*
Int4
-
Posição
product
*
Int4
-
ID do Produto
title
Varchar
150
Titulo
image
*
Varchar
-
URL da Imagem
video
Varchar
-
Video
skus
list
-
Lista de SKUs vinculados a imagem
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/1.0/images/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/images/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/1.0/images/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo a imagem
Produto - Fornecedores
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 1 ,
"next" : null ,
"previous" : null ,
"results" : [
{
"url" : "/api/1.0/distributors/2/" ,
"id" : 2 ,
"name" : "Teste" ,
"active" : true ,
"min_value" : null ,
"single_purchase" : false ,
"add_date" : "2019-10-04T17:08:59.085531" ,
"change_date" : "2019-10-04T17:08:59.085576" ,
"reference_code" : null
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/1.0/distributors/
Filtros via Query Parameters
Parameter
Description
id
ID do distribuidor
name__icontains
Nome que contenha
active
Ativo (1 = Sim, 0 = Não)
reference_code
Codigo de referencia
reference_code__isnull
Somente referencias vazias
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da marca
name
*
Varchar
500
Titulo
active
Boolean
1
Indica se esta ativo default = true
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/1.0/distributors/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "/api/1.0/distributors/2/" ,
"id" : 2 ,
"name" : "Teste" ,
"active" : true ,
"min_value" : null ,
"single_purchase" : false ,
"add_date" : "2019-10-04T17:08:59.085531" ,
"change_date" : "2019-10-04T17:08:59.085576" ,
"reference_code" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao distribuidor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da marca
name
*
Varchar
500
Titulo
active
Boolean
1
Indica se esta ativo default = true
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Criação
HTTP Request
POST /{ENVIRONMENT}/api/1.0/distributors/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/"
-H "Authorization: Token API_KEY"
-X POST
-F < JSON >
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "/api/1.0/distributors/2/" ,
"id" : 2 ,
"name" : "Teste" ,
"active" : true ,
"min_value" : null ,
"single_purchase" : false ,
"add_date" : "2019-10-04T17:08:59.085531" ,
"change_date" : "2019-10-04T17:08:59.085576" ,
"reference_code" : null
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da marca
name
*
Varchar
500
Titulo
active
Boolean
1
Indica se esta ativo default = true
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/1.0/distributors/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/"
-H "Authorization: Token API_KEY"
-X PUT
-F < JSON >
O comando acima retonar um JSON conforme estrutura abaixo:
{
"url" : "/api/1.0/distributors/2/" ,
"id" : 2 ,
"name" : "Teste" ,
"active" : true ,
"min_value" : null ,
"single_purchase" : false ,
"add_date" : "2019-10-04T17:08:59.085531" ,
"change_date" : "2019-10-04T17:08:59.085576" ,
"reference_code" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao distribuidor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da marca
name
*
Varchar
500
Titulo
active
Boolean
1
Indica se esta ativo default = true
reference_code
Varchar
64
Código de referência ou código da grade no ERP
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/1.0/distributors/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/distributors/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/1.0/distributors/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo ao distribuidor
SKU`s
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do SKU
product
Int4
-
ID da categoria
title
Varchar
255
Titulo do SKU
ean_13
Varchar
255
EAN13 ou Código de barras
reference_code
Varchar
64
Código de referência ou código da grade no ERP
weight
Numeric
10,3
Peso
height
Numeric
10,3
Altura
width
Numeric
10,3
Largura
depth
Numeric
10,3
Profundidade
cost_price
Numeric
10,2
Preço de Custo
unit_price
Numeric
10,2
Preço de Venda
sale_price
Numeric
10,2
Preço de Venda Promocional
stock
Int4
-
Estoque
reserves_stock
Int4
-
Estoque Reserva
minimum_stock
Int4
-
Estoque mínimo
max_buy
Int4
-
Quantidade máxima de compra
available
Boolean
1
Indica se o SKU esta disponivel para venda default = true
default
Boolean
1
Indica se o SKU é o principal default = false
image
Int4
-
ID da Imagem
options
Array(Int4)
-
ID`s dos valores das opções do SKU
availability
Int4
-
Disponibilidade do SKU ou Tempo de manuseio do produto
sell_out_of_stock
Boolean
1
Vender SKU sem estoque default = False
Lista
Lista de SKU`s
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/skus/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/skus/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 1 ,
"next" : null ,
"previous" : null ,
"results" : [
{
"id" : 1699 ,
"title" : null ,
"ean_13" : null ,
"reference_code" : null ,
"weight" : "0.000" ,
"height" : null ,
"width" : null ,
"depth" : null ,
"cost_price" : null ,
"unit_price" : null ,
"sale_price" : null ,
"stock" : 0 ,
"reserves_stock" : 0 ,
"minimum_stock" : 0 ,
"max_buy" : null ,
"available" : true ,
"default" : false ,
"add_date" : "2016-10-08T12:52:37.028820" ,
"change_date" : "2016-10-08T12:52:37.028856" ,
"options" : [
21 ,
17
],
"availability" : null ,
"sell_out_of_stock" : false ,
"product" : 1664 ,
"image" : null
},
{
"id" : 1700 ,
"title" : null ,
"ean_13" : null ,
"reference_code" : null ,
"weight" : "0.000" ,
"height" : null ,
"width" : null ,
"depth" : null ,
"cost_price" : null ,
"unit_price" : null ,
"sale_price" : null ,
"stock" : 0 ,
"reserves_stock" : 0 ,
"minimum_stock" : 0 ,
"max_buy" : null ,
"available" : true ,
"default" : false ,
"add_date" : "2016-10-08T12:52:37.286080" ,
"change_date" : "2016-10-08T12:52:37.286104" ,
"options" : [
21 ,
19
],
"availability" : null ,
"sell_out_of_stock" : false ,
"product" : 1664 ,
"image" : null
}
]
}
HTTP Request
GET {ENVIRONMENT}/api/1.0/skus/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID do produto
reference_code
Código de referência ou código da grade no ERP
ean_13
Filtro pelo EAN13 ou Código de barras
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Detalhes
HTTP Request
GET {ENVIRONMENT}/api/1.0/skus/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/skus/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/skus/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1699 ,
"title" : null ,
"ean_13" : null ,
"reference_code" : null ,
"weight" : "0.000" ,
"height" : null ,
"width" : null ,
"depth" : null ,
"cost_price" : null ,
"unit_price" : null ,
"sale_price" : null ,
"stock" : 0 ,
"reserves_stock" : 0 ,
"minimum_stock" : 0 ,
"max_buy" : null ,
"available" : true ,
"default" : false ,
"add_date" : "2016-10-08T12:52:37.028820" ,
"change_date" : "2016-10-08T12:52:37.028856" ,
"options" : [
21 ,
17
],
"availability" : null ,
"sell_out_of_stock" : false ,
"product" : 1664 ,
"image" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao SKU
Criação
HTTP Request
POST {ENVIRONMENT}/api/1.0/skus/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/skus/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/skus/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"id" : 1699 ,
"weight" : "0.000" ,
"stock" : 0 ,
"reserves_stock" : 0 ,
"minimum_stock" : 0 ,
"available" : true ,
"default" : false ,
"options" : [
21 ,
17
],
"sell_out_of_stock" : false ,
"product" : 1664
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1699 ,
"title" : null ,
"ean_13" : null ,
"reference_code" : null ,
"weight" : "0.000" ,
"height" : null ,
"width" : null ,
"depth" : null ,
"cost_price" : null ,
"unit_price" : null ,
"sale_price" : null ,
"stock" : 0 ,
"reserves_stock" : 0 ,
"minimum_stock" : 0 ,
"max_buy" : null ,
"available" : true ,
"default" : false ,
"add_date" : "2016-10-08T12:52:37.028820" ,
"change_date" : "2016-10-08T12:52:37.028856" ,
"options" : [
21 ,
17
],
"availability" : null ,
"sell_out_of_stock" : false ,
"product" : 1664 ,
"image" : null
}
Alteração
HTTP Request
PUT {ENVIRONMENT}/api/1.0/skus/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/skus/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/skus/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"id" : 1699 ,
"weight" : "0.000" ,
"stock" : 0 ,
"reserves_stock" : 0 ,
"minimum_stock" : 0 ,
"available" : true ,
"default" : false ,
"options" : [
21 ,
17
],
"sell_out_of_stock" : false ,
"product" : 1664
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1699 ,
"title" : null ,
"ean_13" : null ,
"reference_code" : null ,
"weight" : "0.000" ,
"height" : null ,
"width" : null ,
"depth" : null ,
"cost_price" : null ,
"unit_price" : null ,
"sale_price" : null ,
"stock" : 0 ,
"reserves_stock" : 0 ,
"minimum_stock" : 0 ,
"max_buy" : null ,
"available" : true ,
"default" : false ,
"add_date" : "2016-10-08T12:52:37.028820" ,
"change_date" : "2016-10-08T12:52:37.028856" ,
"options" : [
21 ,
17
],
"availability" : null ,
"sell_out_of_stock" : false ,
"product" : 1664 ,
"image" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao SKU
Pedidos
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
reference_code
Varchar
64
Código de referência no marketplace
erp_code
Varchar
64
Código de referência ou código da grade no ERP
customer
*
Int4
-
ID do cliente
billing_detail_name
*
Varchar
100
Nome do cliente
billing_detail_document
*
Varchar
100
Documento do cliente
billing_detail_address
*
Varchar
100
Endereço
billing_detail_number
*
Varchar
100
Número
billing_detail_complement
*
Varchar
100
Complemento
billing_detail_neighborhood
*
Varchar
100
Bairro
billing_detail_city
*
Varchar
100
Cidade
billing_detail_state
*
Varchar
100
Estado
billing_detail_postcode
*
Varchar
100
CEP
billing_detail_phone
*
Varchar
100
Telefone
billing_detail_email
*
Varchar
100
E-mail do cliente
shipping_detail_name
*
Varchar
100
Nome do cliente
shipping_detail_document
*
Varchar
100
Documento do cliente
shipping_detail_address
*
Varchar
100
Endereço
shipping_detail_number
*
Varchar
100
Número
shipping_detail_complement
*
Varchar
100
Complemento
shipping_detail_neighborhood
*
Varchar
100
Bairro
shipping_detail_city
*
Varchar
100
Cidade
shipping_detail_state
*
Varchar
100
Estado
shipping_detail_postcode
*
Varchar
100
CEP
shipping_detail_phone
*
Varchar
100
Telefone
shipping_detail_email
*
Varchar
100
E-mail do cliente
shipping_total
*
Numeric
10,2
Custo do envio
shipping_discount
*
Numeric
10,2
Desconto no envio
shipping_delivery_date
*
Date
-
Data de entrega
shipping_type
*
Varchar
50
Tipo de entrega
shipping_delivery_date
*
Date
-
Data de entrega
pickup_store
*
Int4
-
ID da loja para retirada
item_total
*
Numeric
10,2
Total do pedido em itens
discount_total
*
Numeric
10,2
Total de desconto
total
*
Numeric
10,2
Total do pedido
payment_method
*
Varchar
50
Forma de pagamento
institution
*
Varchar
50
Instituição Financeira
installments
*
Int4
50
Parcelas
captured
Boolean
1
Informa se o pedido esta capturado
status
*
Varchar
50
Status do pedido
channel
*
Int4
50
Código do canal de compra
observation
Text
-
Texto do observação
transaction_id
Varchar
150
Código da transação
pan
Varchar
100
PAN da transação
nsu
Varchar
100
NSU da transação
card_mask
Varchar
25
Cartão mascarado
ip_addrress
Inet
-
IP da transação
weddinglist
Int4
-
ID da lista de presente
seller
Int4
-
ID do vendedor
items
*
List
-
Lista de items do pedido
items.order
*
Int4
-
ID do pedido
items.sku
*
Int4
-
ID do item
items.description
*
Varchar
200
ID do item
items.quantity
*
Int4
-
Quantidade do item
items.unit_price
*
Numeric
10,2
Preço unitário
items.total_price
*
Numeric
10,2
Preço total
items.discount
*
Numeric
10,2
Desconto no item
items.is_gift
*
Boolean
1
Informa se o item é presente
trackers
List
-
Lista de códigos de rastreio
trackers.id
*
Int4
-
ID do código de rastreio
trackers.order
*
Int4
-
ID do pedido
trackers.code
*
Varchar
100
Código do Rastreio
trackers.status
*
Varchar
50
Status do pedido
invoices
List
-
Lista de notas fiscais
trackers.id
*
Int4
-
ID da nota fiscal
trackers.order
*
Int4
-
ID do pedido
trackers.key
*
Varchar
100
Código da Nota Fiscal
trackers.date_issue
*
Datetime
-
Data de emissão (yyyy-mm-ddTHH:ii:ss)
trackers.series
*
Varchar
50
Serie da Nota Fiscal
trackers.total
*
Numeric
10,2
Total da Nota Fiscal
Lista
Lista de pedidos
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 114 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/?page=2" ,
"previous" : null ,
"results" : [
{
"id" : 172 ,
"reference_code" : null ,
"erp_code" : null ,
"customer" : 1 ,
"billing_detail_name" : "TESTE NOME" ,
"billing_detail_document" : "12312312312" ,
"billing_detail_address" : "R BERNARDINO DE CAMPOS" ,
"billing_detail_number" : "1001" ,
"billing_detail_complement" : "SALA 1001" ,
"billing_detail_neighborhood" : "CENTRO" ,
"billing_detail_city" : "RIBEIRÃO PRETO" ,
"billing_detail_state" : "SP" ,
"billing_detail_postcode" : "14015130" ,
"billing_detail_phone" : "(16) 30757676" ,
"billing_detail_email" : "dev@convertize.com.br" ,
"shipping_detail_name" : "TESTE NOME" ,
"shipping_detail_document" : "12312312312" ,
"shipping_detail_address" : "R BERNARDINO DE CAMPOS" ,
"shipping_detail_number" : "1001" ,
"shipping_detail_complement" : "SALA 1001" ,
"shipping_detail_neighborhood" : "CENTRO" ,
"shipping_detail_city" : "RIBEIRÃO PRETO" ,
"shipping_detail_state" : "SP" ,
"shipping_detail_postcode" : "14015130" ,
"shipping_detail_phone" : "(16) 30757676" ,
"shipping_detail_email" : "dev@convertize.com.br" ,
"shipping_total" : "13.50" ,
"shipping_discount" : "0.00" ,
"shipping_delivery_date" : "2016-08-05" ,
"item_total" : "260.00" ,
"discount_total" : "0.00" ,
"total" : "273.50" ,
"payment_method" : "Boleto" ,
"institution" : "Bancodobrasil" ,
"installments" : 1 ,
"captured" : false ,
"status" : "PEN" ,
"channel" : 0 ,
"observation" : null ,
"transaction_id" : null ,
"pan" : null ,
"nsu" : null ,
"card_mask" : null ,
"ip_addrress" : "127.0.0.1" ,
"weddinglist" : null ,
"seller" : null ,
"add_date" : "2016-07-26T17:06:11.408989" ,
"update_date" : "2016-07-26T17:06:20.554219" ,
"items" : [
{
"order" : 172 ,
"sku" : 1694 ,
"description" : "COMBO TESTE" ,
"quantity" : 4 ,
"unit_price" : "20.00" ,
"total_price" : "80.00" ,
"discount" : "0.00" ,
"delivery_time" : null ,
"shipping_type" : null ,
"is_gift" : false
},
{
"order" : 172 ,
"sku" : 1693 ,
"description" : "COMBO TESTE" ,
"quantity" : 4 ,
"unit_price" : "45.00" ,
"total_price" : "180.00" ,
"discount" : "0.00" ,
"delivery_time" : null ,
"shipping_type" : null ,
"is_gift" : false
}
]
},
{
"id" : 171 ,
"reference_code" : null ,
"erp_code" : null ,
"customer" : 1 ,
"billing_detail_name" : "TESTE NOME" ,
"billing_detail_document" : "12312312312" ,
"billing_detail_address" : "R BERNARDINO DE CAMPOS" ,
"billing_detail_number" : "1001" ,
"billing_detail_complement" : "SALA 1001" ,
"billing_detail_neighborhood" : "CENTRO" ,
"billing_detail_city" : "RIBEIRÃO PRETO" ,
"billing_detail_state" : "SP" ,
"billing_detail_postcode" : "14015130" ,
"billing_detail_phone" : "(16) 30757676" ,
"billing_detail_email" : "dev@convertize.com.br" ,
"shipping_detail_name" : "TESTE NOME" ,
"shipping_detail_document" : "12312312312" ,
"shipping_detail_address" : "R BERNARDINO DE CAMPOS" ,
"shipping_detail_number" : "1001" ,
"shipping_detail_complement" : "SALA 1001" ,
"shipping_detail_neighborhood" : "CENTRO" ,
"shipping_detail_city" : "RIBEIRÃO PRETO" ,
"shipping_detail_state" : "SP" ,
"shipping_detail_postcode" : "14015130" ,
"shipping_detail_phone" : "(16) 30757676" ,
"shipping_detail_email" : "dev@convertize.com.br" ,
"shipping_total" : "13.50" ,
"shipping_discount" : "0.00" ,
"shipping_delivery_date" : "2016-08-05" ,
"item_total" : "195.00" ,
"discount_total" : "0.00" ,
"total" : "208.50" ,
"payment_method" : "Boleto" ,
"institution" : "Bancodobrasil" ,
"installments" : 1 ,
"captured" : false ,
"status" : "PEN" ,
"channel" : 0 ,
"observation" : null ,
"transaction_id" : null ,
"pan" : null ,
"nsu" : null ,
"card_mask" : null ,
"ip_addrress" : "127.0.0.1" ,
"weddinglist" : null ,
"seller" : null ,
"add_date" : "2016-07-26T16:55:25.319729" ,
"update_date" : "2016-07-26T16:55:49.012298" ,
"items" : [
{
"order" : 171 ,
"sku" : 1694 ,
"description" : "COMBO TESTE" ,
"quantity" : 3 ,
"unit_price" : "20.00" ,
"total_price" : "60.00" ,
"discount" : "0.00" ,
"delivery_time" : null ,
"shipping_type" : null ,
"is_gift" : false
},
{
"order" : 171 ,
"sku" : 1693 ,
"description" : "COMBO TESTE" ,
"quantity" : 3 ,
"unit_price" : "45.00" ,
"total_price" : "135.00" ,
"discount" : "0.00" ,
"delivery_time" : null ,
"shipping_type" : null ,
"is_gift" : false
}
]
}
]
}
HTTP Request
GET {ENVIRONMENT}/api/1.0/orders/
Filtros via Query Parameters
Parameter
Description
id
ID do pedido
reference_code
Código de referência no marketplace
erp_code
Código de referência no ERP
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
update_date__lte
Filtro por data de alteração menor ou igual
update_date__gte
Filtro por data de alteração maior ou igual
Detalhes
HTTP Request
GET {ENVIRONMENT}/api/1.0/orders/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 172 ,
"reference_code" : null ,
"erp_code" : null ,
"customer" : 1 ,
"billing_detail_name" : "TESTE NOME" ,
"billing_detail_document" : "12312312312" ,
"billing_detail_address" : "R BERNARDINO DE CAMPOS" ,
"billing_detail_number" : "1001" ,
"billing_detail_complement" : "SALA 1001" ,
"billing_detail_neighborhood" : "CENTRO" ,
"billing_detail_city" : "RIBEIRÃO PRETO" ,
"billing_detail_state" : "SP" ,
"billing_detail_postcode" : "14015130" ,
"billing_detail_phone" : "(16) 30757676" ,
"billing_detail_email" : "dev@convertize.com.br" ,
"shipping_detail_name" : "TESTE NOME" ,
"shipping_detail_document" : "12312312312" ,
"shipping_detail_address" : "R BERNARDINO DE CAMPOS" ,
"shipping_detail_number" : "1001" ,
"shipping_detail_complement" : "SALA 1001" ,
"shipping_detail_neighborhood" : "CENTRO" ,
"shipping_detail_city" : "RIBEIRÃO PRETO" ,
"shipping_detail_state" : "SP" ,
"shipping_detail_postcode" : "14015130" ,
"shipping_detail_phone" : "(16) 30757676" ,
"shipping_detail_email" : "dev@convertize.com.br" ,
"shipping_total" : "13.50" ,
"shipping_discount" : "0.00" ,
"shipping_delivery_date" : "2016-08-05" ,
"item_total" : "260.00" ,
"discount_total" : "0.00" ,
"total" : "273.50" ,
"payment_method" : "Boleto" ,
"institution" : "Bancodobrasil" ,
"installments" : 1 ,
"captured" : false ,
"status" : "PEN" ,
"channel" : 0 ,
"observation" : null ,
"transaction_id" : null ,
"pan" : null ,
"nsu" : null ,
"card_mask" : null ,
"ip_addrress" : "127.0.0.1" ,
"weddinglist" : null ,
"seller" : null ,
"add_date" : "2016-07-26T17:06:11.408989" ,
"update_date" : "2016-07-26T17:06:20.554219" ,
"items" : [
{
"order" : 172 ,
"sku" : 1694 ,
"description" : "COMBO TESTE" ,
"quantity" : 4 ,
"unit_price" : "20.00" ,
"total_price" : "80.00" ,
"discount" : "0.00" ,
"delivery_time" : null ,
"shipping_type" : null ,
"is_gift" : false
},
{
"order" : 172 ,
"sku" : 1693 ,
"description" : "COMBO TESTE" ,
"quantity" : 4 ,
"unit_price" : "45.00" ,
"total_price" : "180.00" ,
"discount" : "0.00" ,
"delivery_time" : null ,
"shipping_type" : null ,
"is_gift" : false
}
]
}
URL Parameters
Parameter
Description
ID
ID relativo ao pedido
Alteração de status
HTTP Request
PUT {ENVIRONMENT}/api/1.0/orders/{ID}/status/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/status/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/status/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"status" : "PEN"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"status" : "PEN"
}
URL Parameters
Parameter
Description
ID
ID relativo ao pedido
Lista de status
Código
Descrição
PEN
Pedido Realizado com Sucesso
AADF
Aguardando Análise
CEP
Pagamento Recebido
PES
Em Separação
ETP
Entregue a Transportadora
PECS
Entregue
PNA
Pagamento não Aprovado
PEC
Pagamento em Contestação
PCD
Chargeback
PDV
Pagamento Devolvido
PED
Pagamento em Disputa
PDPN
Pagamento Dísponível
CANM
Cancelado
Código de Rastreio
HTTP Request Create
POST {ENVIRONMENT}/api/1.0/orders/{ID}/trackers/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/trackers/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/trackers/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"code" : "SW902295112BR" ,
"status" : "ETP"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 84 ,
"order" : 172 ,
"code" : "SW902295112BR" ,
"status" : "ETP" ,
"add_date" : "2016-10-11T16:10:38.626884" ,
"update_date" : "2016-10-11T16:10:38.626930"
}
URL Parameters
Parameter
Description
ID
ID relativo ao pedido
Lista de status
Código
Descrição
PEN
Pedido Realizado com Sucesso
AADF
Aguardando Análise
CEP
Pagamento Recebido
PES
Em Separação
ETP
Entregue a Transportadora
PECS
Entregue
PNA
Pagamento não Aprovado
PEC
Pagamento em Contestação
PCD
Chargeback
PDV
Pagamento Devolvido
PED
Pagamento em Disputa
PDPN
Pagamento Dísponível
CANM
Cancelado
HTTP Request Delete
DELETE {ENVIRONMENT}/api/1.0/orders/{ID}/trackers/{TRACKER_ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/trackers/<TRACKER_ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/trackers/<TRACKER_ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X DELETE
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo ao pedido
TRACKER_ID
ID relativo ao código de rastreio
Nota Fiscal
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da nota fiscal
order
*
Int4
-
ID do pedido
reference_code
Varchar
64
Código de referência da nota
key
*
Varchar
100
Chave da nota fiscal ou invoice
series
*
Varchar
50
Serie da nota fiscal
date_issue
*
Datetime
-
Data de emissão (yyyy-mm-ddTHH:ii:ss)
total
*
Numeric
10,2
Total da nota
HTTP Request Create
POST {ENVIRONMENT}/api/1.0/orders/{ID}/invoices/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/invoices/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/invoices/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"order" : 172 ,
"key" : "12312312313212" ,
"series" : "123" ,
"reference_code" : "01" ,
"date_issue" : "1989-10-01T10:59:59" ,
"total" : "150.50"
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 9 ,
"order" : 172 ,
"reference_code" : "01" ,
"key" : "12312312313212" ,
"series" : "123" ,
"date_issue" : "1989-10-01T10:59:59" ,
"total" : "150.50" ,
"add_date" : "2016-10-11T16:35:44.614333" ,
"update_date" : "2016-10-11T16:35:44.614360"
}
URL Parameters
Parameter
Description
ID
ID relativo ao pedido
HTTP Request Delete
DELETE {ENVIRONMENT}/api/1.0/orders/{ID}/trackers/{INVOICE_ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/trackers/<INVOICE_ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/orders/<ID>/trackers/<INVOICE_ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X DELETE
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo ao pedido
INVOICE_ID
ID relativo a nota fiscal
Logística - Estoques
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/v2/logistics/stocks/skus/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/logistics/stocks/skus/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 6 ,
"next" : null ,
"previous" : null ,
"results" : [
{
"id" : 1 ,
"stock" : 1 ,
"sku" : 1676 ,
"quantity" : 10 ,
"infinity" : false
},
{
"id" : 2 ,
"stock" : 1 ,
"sku" : 1669 ,
"quantity" : 5 ,
"infinity" : false
},
{
"id" : 3 ,
"stock" : 1 ,
"sku" : 1 ,
"quantity" : 3 ,
"infinity" : false
},
{
"id" : 4 ,
"stock" : 1 ,
"sku" : 2 ,
"quantity" : 3 ,
"infinity" : false
},
{
"id" : 6 ,
"stock" : 2 ,
"sku" : 2 ,
"quantity" : 1 ,
"infinity" : false
},
{
"id" : 5 ,
"stock" : 2 ,
"sku" : 1 ,
"quantity" : 1 ,
"infinity" : false
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/v2/logistics/stocks/skus/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID do estoque
sku
Filtro pelo ID do SKU
sku__in
Filtro pela lista de ID do SKU separados por ,
quantity__gte
Filtro por data de criação maior ou igual
quantity__lte
Filtro por data de alteração menor ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do Stock
sku
*
Int4
-
ID do SKU
quantity
*
Int4
-
Estoque
infinity
*
Boolean
1
Indica se o estoque é infinito default = false
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/v2/logistics/stocks/skus/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/logistics/stocks/skus/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/logistics/stocks/skus/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1 ,
"stock" : 1 ,
"sku" : 1676 ,
"quantity" : 10 ,
"infinity" : false
}
URL Parameters
Parameter
Description
ID
ID relativo ao Estoque
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do Stock
sku
*
Int4
-
ID do SKU
quantity
*
Int4
-
Estoque
infinity
*
Boolean
1
Indica se o estoque é infinito default = false
Criação
HTTP Request
POST /{ENVIRONMENT}/api/v2/logistics/stocks/skus/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/logistics/stocks/skus/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
}, data = {
"stock" : 1 ,
"sku" : 1676 ,
"quantity" : 10 ,
"infinity" : false
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/logistics/stocks/skus/"
-H "Authorization: Token API_KEY"
-H "Content-Type: multipart/form-data"
-X POST -d '<JSON>'
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1 ,
"stock" : 1 ,
"sku" : 1676 ,
"quantity" : 10 ,
"infinity" : false
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do Stock
sku
*
Int4
-
ID do SKU
quantity
*
Int4
-
Estoque
infinity
*
Boolean
1
Indica se o estoque é infinito default = false
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/v2/logistics/stocks/skus/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/logistics/stocks/skus/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
}, data = {
"stock" : 1 ,
"sku" : 1676 ,
"quantity" : 10 ,
"infinity" : false
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/logistics/stocks/skus/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: multipart/form-data"
-X PUT -d '<JSON>'
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 1 ,
"stock" : 1 ,
"sku" : 1676 ,
"quantity" : 10 ,
"infinity" : false
}
URL Parameters
Parameter
Description
ID
ID relativo ao Estoque
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do Stock
sku
*
Int4
-
ID do SKU
quantity
*
Int4
-
Estoque
infinity
*
Boolean
1
Indica se o estoque é infinito default = false
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/v2/logistics/stocks/skus/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/logistics/stocks/skus/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/v2/logistics/stocks/skus/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo ao Estoque
Precificação - Tabela
Lista
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/v2/pricing/prices/skus/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/pricing/prices/skus/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 62 ,
"next" : null ,
"previous" : null ,
"results" : [
{
"id" : 64 ,
"table" : 1 ,
"sku" : 1696 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 63 ,
"table" : 1 ,
"sku" : 1695 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 40 ,
"table" : 1 ,
"sku" : 1694 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 61 ,
"table" : 1 ,
"sku" : 1693 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 60 ,
"table" : 1 ,
"sku" : 1692 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 59 ,
"table" : 1 ,
"sku" : 1691 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 58 ,
"table" : 1 ,
"sku" : 1687 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 57 ,
"table" : 1 ,
"sku" : 1686 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 56 ,
"table" : 1 ,
"sku" : 1685 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 55 ,
"table" : 1 ,
"sku" : 1684 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 54 ,
"table" : 1 ,
"sku" : 1683 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 49 ,
"table" : 1 ,
"sku" : 1682 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 48 ,
"table" : 1 ,
"sku" : 1681 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 47 ,
"table" : 1 ,
"sku" : 1680 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 46 ,
"table" : 1 ,
"sku" : 1679 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 51 ,
"table" : 1 ,
"sku" : 1678 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 50 ,
"table" : 1 ,
"sku" : 1677 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 38 ,
"table" : 1 ,
"sku" : 1676 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 37 ,
"table" : 1 ,
"sku" : 1675 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 36 ,
"table" : 1 ,
"sku" : 1674 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 35 ,
"table" : 1 ,
"sku" : 1673 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 34 ,
"table" : 1 ,
"sku" : 1672 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 33 ,
"table" : 1 ,
"sku" : 1671 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 32 ,
"table" : 1 ,
"sku" : 1670 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 31 ,
"table" : 1 ,
"sku" : 1669 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 30 ,
"table" : 1 ,
"sku" : 1668 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 29 ,
"table" : 1 ,
"sku" : 1667 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 21 ,
"table" : 1 ,
"sku" : 1645 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 22 ,
"table" : 1 ,
"sku" : 1644 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 23 ,
"table" : 1 ,
"sku" : 1643 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 27 ,
"table" : 1 ,
"sku" : 1642 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 26 ,
"table" : 1 ,
"sku" : 1641 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 25 ,
"table" : 1 ,
"sku" : 1640 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 24 ,
"table" : 1 ,
"sku" : 1639 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 17 ,
"table" : 1 ,
"sku" : 1377 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 3 ,
"table" : 1 ,
"sku" : 106 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 12 ,
"table" : 1 ,
"sku" : 32 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 11 ,
"table" : 1 ,
"sku" : 31 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 10 ,
"table" : 1 ,
"sku" : 29 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 9 ,
"table" : 1 ,
"sku" : 28 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 8 ,
"table" : 1 ,
"sku" : 27 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 15 ,
"table" : 1 ,
"sku" : 26 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 6 ,
"table" : 1 ,
"sku" : 22 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 4 ,
"table" : 1 ,
"sku" : 21 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 5 ,
"table" : 1 ,
"sku" : 20 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "10.00000"
},
{
"id" : 16 ,
"table" : 1 ,
"sku" : 19 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 18 ,
"table" : 1 ,
"sku" : 18 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 39 ,
"table" : 1 ,
"sku" : 16 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 28 ,
"table" : 1 ,
"sku" : 15 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 14 ,
"table" : 1 ,
"sku" : 14 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 13 ,
"table" : 1 ,
"sku" : 12 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 20 ,
"table" : 1 ,
"sku" : 11 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 45 ,
"table" : 1 ,
"sku" : 10 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 43 ,
"table" : 1 ,
"sku" : 9 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 42 ,
"table" : 1 ,
"sku" : 8 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 41 ,
"table" : 1 ,
"sku" : 7 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 44 ,
"table" : 1 ,
"sku" : 6 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 62 ,
"table" : 1 ,
"sku" : 5 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 53 ,
"table" : 1 ,
"sku" : 4 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 52 ,
"table" : 1 ,
"sku" : 3 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
},
{
"id" : 19 ,
"table" : 1 ,
"sku" : 2 ,
"value_type" : "nominal" ,
"field_discount" : "unit_price" ,
"value" : "750.00000"
},
{
"id" : 7 ,
"table" : 1 ,
"sku" : 1 ,
"value_type" : "percent" ,
"field_discount" : "sale_price" ,
"value" : "50.00000"
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/v2/pricing/prices/skus/
Filtros via Query Parameters
Parameter
Description
id
Filtro pelo ID
table
Filtro pelo ID da tabela
sku
Filtro pelo ID do SKU
sku__in
Filtro pela lista de ID do SKU separados por ,
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do preço
table
*
Int4
-
ID da Tabela
sku
*
Int4
-
ID do SKU
value_type
*
Varchar
-
Tipo do valor (percent, nominal)
field_discount
*
Varchar
-
Campo usado para calculo do desconto (cost_price, unit_price, sale_price)
value
*
Double
10,4
Valor do desconto
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/v2/pricing/prices/skus/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/pricing/prices/skus/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/pricing/prices/skus/<ID>/"
-H "Authorization: Token API_KEY"
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 64 ,
"table" : 1 ,
"sku" : 1696 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
}
URL Parameters
Parameter
Description
ID
ID relativo ao preço
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do preço
table
*
Int4
-
ID da Tabela
sku
*
Int4
-
ID do SKU
value_type
*
Varchar
-
Tipo do valor (percent, nominal)
field_discount
*
Varchar
-
Campo usado para calculo do desconto (cost_price, unit_price, sale_price)
value
*
Double
10,4
Valor do desconto
Criação
HTTP Request
POST /{ENVIRONMENT}/api/v2/pricing/prices/skus/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/pricing/prices/skus/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
}, data = {
"table" : 1 ,
"sku" : 1696 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/pricing/prices/skus/"
-H "Authorization: Token API_KEY"
-H "Content-Type: multipart/form-data"
-X POST -d '<JSON>'
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 64 ,
"table" : 1 ,
"sku" : 1696 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do preço
table
*
Int4
-
ID da Tabela
sku
*
Int4
-
ID do SKU
value_type
*
Varchar
-
Tipo do valor (percent, nominal)
field_discount
*
Varchar
-
Campo usado para calculo do desconto (cost_price, unit_price, sale_price)
value
*
Double
10,4
Valor do desconto
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/v2/pricing/prices/skus/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/pricing/prices/skus/<ID>/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
}, data = {
"table" : 1 ,
"sku" : 1696 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/pricing/prices/skus/<ID>/"
-H "Authorization: Token API_KEY"
-H "Content-Type: multipart/form-data"
-X PUT -d '<JSON>'
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 64 ,
"table" : 1 ,
"sku" : 1696 ,
"value_type" : "percent" ,
"field_discount" : "unit_price" ,
"value" : "0.00000"
}
URL Parameters
Parameter
Description
ID
ID relativo ao preço
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do preço
table
*
Int4
-
ID da Tabela
sku
*
Int4
-
ID do SKU
value_type
*
Varchar
-
Tipo do valor (percent, nominal)
field_discount
*
Varchar
-
Campo usado para calculo do desconto (cost_price, unit_price, sale_price)
value
*
Double
10,4
Valor do desconto
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/v2/pricing/prices/skus/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/pricing/prices/skus/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/v2/pricing/prices/skus/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo ao preço
Lista de Presente
Lista
Lista de Listas de Presente
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/" );
var request = new RestRequest ( "/giftlists/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 188 ,
"next" : "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/?page=2" ,
"previous" : null ,
"results" : [
{
"id" : 24 ,
"reference_code" : "" ,
"url" : "/lista/presente/isabella-magalhaes-e-murillo-augusto-moreira-bonamini/24/" ,
"type_list" : 4 ,
"customer" : 72 ,
"date" : "2018-12-29" ,
"state" : null ,
"city" : null ,
"guests" : null ,
"message" : null ,
"collection" : null ,
"notification" : true ,
"publish" : true ,
"status" : "A" ,
"ceremony_zipcode" : "" ,
"ceremony_address" : "" ,
"ceremony_number" : "" ,
"ceremony_neighborhood" : "" ,
"ceremony_complement" : "" ,
"ceremony_city" : "" ,
"ceremony_state" : null ,
"reception_zipcode" : "" ,
"reception_address" : "" ,
"reception_number" : "" ,
"reception_neighborhood" : "" ,
"reception_complement" : "" ,
"reception_city" : "" ,
"reception_state" : null ,
"name" : "Isabella Magalhães" ,
"email" : "isahiroshima1999@gmail.com" ,
"mother_name" : "Andreia Magalhães" ,
"father_name" : "Sidney Cortiglio" ,
"partner_name" : "Murillo Augusto Moreira Bonamini" ,
"partner_email" : "" ,
"partner_mother_name" : "Andrea Bonamini" ,
"partner_father_name" : "Gilberto Bonamini" ,
"shipping_zipcode" : "37580-000" ,
"shipping_address" : "Rua Bahia" ,
"shipping_number" : "261" ,
"shipping_neighborhood" : "Magioli" ,
"shipping_complement" : "Loja" ,
"shipping_city" : "MONTE SIÃO" ,
"shipping_state" : "MG" ,
"shipping_date" : null ,
"shipping_description" : null ,
"add_date" : "2018-07-02T17:05:26.448387" ,
"change_date" : "2018-07-02T17:21:02.975380" ,
"user" : null ,
"giftcard" : null ,
"gift_items" : []
},
{
"id" : 23 ,
"reference_code" : "" ,
"url" : "/lista/presente/leonardo-moreira-e-jessica-lopes-de-lima/23/" ,
"type_list" : 1 ,
"customer" : 69 ,
"date" : "2018-07-25" ,
"state" : null ,
"city" : null ,
"guests" : null ,
"message" : "" ,
"collection" : null ,
"notification" : true ,
"publish" : true ,
"status" : "E" ,
"ceremony_zipcode" : "" ,
"ceremony_address" : "" ,
"ceremony_number" : "" ,
"ceremony_neighborhood" : "" ,
"ceremony_complement" : "" ,
"ceremony_city" : "" ,
"ceremony_state" : null ,
"reception_zipcode" : "" ,
"reception_address" : "" ,
"reception_number" : "" ,
"reception_neighborhood" : "" ,
"reception_complement" : "" ,
"reception_city" : "" ,
"reception_state" : null ,
"name" : "Leonardo Moreira" ,
"email" : "leomoreiraa.94@gmail.com" ,
"mother_name" : "Benedita Ap. Pinto" ,
"father_name" : "Leonel Moreira" ,
"partner_name" : "Jéssica Lopes de Lima" ,
"partner_email" : "jessicahlima431@gmail.com" ,
"partner_mother_name" : "Tatiane Marques Lopes" ,
"partner_father_name" : "José Edilson de Lima" ,
"shipping_zipcode" : "18460-000" ,
"shipping_address" : "Rua Lauro Novaes Ribas" ,
"shipping_number" : "23" ,
"shipping_neighborhood" : "Tonico Adolfo" ,
"shipping_complement" : "Casa" ,
"shipping_city" : "ITARARÉ" ,
"shipping_state" : "SP" ,
"shipping_date" : null ,
"shipping_description" : "" ,
"add_date" : "2018-06-22T03:46:40.451939" ,
"change_date" : "2018-06-25T13:12:38.486048" ,
"user" : null ,
"giftcard" : null ,
"gift_items" : []
},
]
}
HTTP Request
GET /{ENVIRONMENT}/api/v2/giftlists/
Filtros via Query Parameters
Parameter
Description
id
ID da Lista
reference_code
Código de referência
type_list
Tipo de lista
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da lista
reference_code
Varchar
64
Código de referência
url
*
Text
-
URL da Lista de Presente (On-Line) gerado automaticamente
type_list
Int4
-
ID do Tipo da Lista
customer
Int4
-
ID do Cliente
date
Date
-
Data do Evento
state
Varchar
2
Estado do Evento
guests
Varchar
2
Número de Convidados
message
Text
Mensagem para os convidados que acessarem a sua lista
collection
Int4
-
ID da coleção, usado para lista pronta
notification
Boolean
1
Deseja receber informações sobre minha lista por e-mail
publish
Boolean
1
Deixar minha lista disponível no site
status
*
Varchar
2
Status da lista (A = Ativa, F = Finalizada, I = Inativa, E = Excluída), default = A
ceremony_zipcode
Varchar
9
CEP do Local da Cerimônia
ceremony_address
Varchar
150
Endereço do Local da Cerimônia
ceremony_number
Varchar
8
Número do Local da Cerimônia
ceremony_neighborhood
Varchar
120
Bairro do Local da Cerimônia
ceremony_complement
Varchar
255
Complemento do Local da Cerimônia
ceremony_city
Varchar
150
Cidade do Local da Cerimônia
ceremony_state
Varchar
2
Estado do Local da Cerimônia
reception_zipcode
Varchar
9
CEP do Local da Festa
reception_address
Varchar
150
Endereço do Local da Festa
reception_number
Varchar
8
Número do Local da Festa
reception_neighborhood
Varchar
120
Bairro do Local da Festa
reception_complement
Varchar
60
Complemento do Local da Festa
reception_city
Varchar
150
Cidade do Local da Festa
reception_state
Varchar
2
Estado do Local da Festa
name
Varchar
255
Nome do dono da Lista
email
Varchar
255
E-mail do dono da Lista
mother_name
Varchar
255
Nome da mãe do dono da Lista
father_name
Varchar
255
Nome do pai do dono da Lista
partner_name
Varchar
255
Nome do parceiro da Lista
partner_email
Varchar
255
E-mail do parceiro da Lista
partner_mother_name
Varchar
255
Nome da mãe do parceiro da Lista
partner_father_name
Varchar
255
Nome do pai do parceiro da Lista
shipping_zipcode
Varchar
9
CEP de Entrega
shipping_address
Varchar
150
Endereço de Entrega
shipping_number
Varchar
8
Número de Entrega
shipping_neighborhood
Varchar
120
Bairro de Entrega
shipping_complement
Varchar
60
Complemento de Entrega
shipping_city
Varchar
150
Cidade de Entrega
shipping_state
Varchar
2
Estado de Entrega
shipping_date
Date
-
Data de entrega
shipping_description
Text
Observação da entrega
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
user
Int4
-
ID do usuario, quando criado pela administração
giftcard
Int4
-
Dados do GiftCard, quando o pedido é entregue por vale. Gerado automaticamente
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/v2/giftlists/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/{ID}/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/" );
var request = new RestRequest ( "/giftlists/{ID}/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 24 ,
"reference_code" : "" ,
"url" : "/lista/presente/isabella-magalhaes-e-murillo-augusto-moreira-bonamini/24/" ,
"type_list" : 4 ,
"customer" : 72 ,
"date" : "2018-12-29" ,
"state" : null ,
"city" : null ,
"guests" : null ,
"message" : null ,
"collection" : null ,
"notification" : true ,
"publish" : true ,
"status" : "A" ,
"ceremony_zipcode" : "" ,
"ceremony_address" : "" ,
"ceremony_number" : "" ,
"ceremony_neighborhood" : "" ,
"ceremony_complement" : "" ,
"ceremony_city" : "" ,
"ceremony_state" : null ,
"reception_zipcode" : "" ,
"reception_address" : "" ,
"reception_number" : "" ,
"reception_neighborhood" : "" ,
"reception_complement" : "" ,
"reception_city" : "" ,
"reception_state" : null ,
"name" : "Isabella Magalhães" ,
"email" : "isahiroshima1999@gmail.com" ,
"mother_name" : "Andreia Magalhães" ,
"father_name" : "Sidney Cortiglio" ,
"partner_name" : "Murillo Augusto Moreira Bonamini" ,
"partner_email" : "" ,
"partner_mother_name" : "Andrea Bonamini" ,
"partner_father_name" : "Gilberto Bonamini" ,
"shipping_zipcode" : "37580-000" ,
"shipping_address" : "Rua Bahia" ,
"shipping_number" : "261" ,
"shipping_neighborhood" : "Magioli" ,
"shipping_complement" : "Loja" ,
"shipping_city" : "MONTE SIÃO" ,
"shipping_state" : "MG" ,
"shipping_date" : null ,
"shipping_description" : null ,
"add_date" : "2018-07-02T17:05:26.448387" ,
"change_date" : "2018-07-02T17:21:02.975380" ,
"user" : null ,
"giftcard" : null ,
"gift_items" : []
}
URL Parameters
Parameter
Description
ID
ID relativo a lista
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da lista
reference_code
Varchar
64
Código de referência
url
*
Text
-
URL da Lista de Presente (On-Line) gerado automaticamente
type_list
Int4
-
ID do Tipo da Lista
customer
Int4
-
ID do Cliente
date
Date
-
Data do Evento
state
Varchar
2
Estado do Evento
guests
Varchar
2
Número de Convidados
message
Text
Mensagem para os convidados que acessarem a sua lista
collection
Int4
-
ID da coleção, usado para lista pronta
notification
Boolean
1
Deseja receber informações sobre minha lista por e-mail
publish
Boolean
1
Deixar minha lista disponível no site
status
*
Varchar
2
Status da lista (A = Ativa, F = Finalizada, I = Inativa, E = Excluída), default = A
ceremony_zipcode
Varchar
9
CEP do Local da Cerimônia
ceremony_address
Varchar
150
Endereço do Local da Cerimônia
ceremony_number
Varchar
8
Número do Local da Cerimônia
ceremony_neighborhood
Varchar
120
Bairro do Local da Cerimônia
ceremony_complement
Varchar
255
Complemento do Local da Cerimônia
ceremony_city
Varchar
150
Cidade do Local da Cerimônia
ceremony_state
Varchar
2
Estado do Local da Cerimônia
reception_zipcode
Varchar
9
CEP do Local da Festa
reception_address
Varchar
150
Endereço do Local da Festa
reception_number
Varchar
8
Número do Local da Festa
reception_neighborhood
Varchar
120
Bairro do Local da Festa
reception_complement
Varchar
60
Complemento do Local da Festa
reception_city
Varchar
150
Cidade do Local da Festa
reception_state
Varchar
2
Estado do Local da Festa
name
Varchar
255
Nome do dono da Lista
email
Varchar
255
E-mail do dono da Lista
mother_name
Varchar
255
Nome da mãe do dono da Lista
father_name
Varchar
255
Nome do pai do dono da Lista
partner_name
Varchar
255
Nome do parceiro da Lista
partner_email
Varchar
255
E-mail do parceiro da Lista
partner_mother_name
Varchar
255
Nome da mãe do parceiro da Lista
partner_father_name
Varchar
255
Nome do pai do parceiro da Lista
shipping_zipcode
Varchar
9
CEP de Entrega
shipping_address
Varchar
150
Endereço de Entrega
shipping_number
Varchar
8
Número de Entrega
shipping_neighborhood
Varchar
120
Bairro de Entrega
shipping_complement
Varchar
60
Complemento de Entrega
shipping_city
Varchar
150
Cidade de Entrega
shipping_state
Varchar
2
Estado de Entrega
shipping_date
Date
-
Data de entrega
shipping_description
Text
Observação da entrega
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
user
Int4
-
ID do usuario, quando criado pela administração
giftcard
Int4
-
Dados do GiftCard, quando o pedido é entregue por vale. Gerado automaticamente
Criação
HTTP Request
POST /{ENVIRONMENT}/api/v2/giftlists/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"reference_code" : "" ,
"type_list" : 4 ,
"customer" : 72 ,
"date" : "2018-12-29" ,
"state" : null ,
"city" : null ,
"guests" : null ,
"message" : null ,
"collection" : null ,
"notification" : true ,
"publish" : true ,
"status" : "A" ,
"ceremony_zipcode" : "" ,
"ceremony_address" : "" ,
"ceremony_number" : "" ,
"ceremony_neighborhood" : "" ,
"ceremony_complement" : "" ,
"ceremony_city" : "" ,
"ceremony_state" : null ,
"reception_zipcode" : "" ,
"reception_address" : "" ,
"reception_number" : "" ,
"reception_neighborhood" : "" ,
"reception_complement" : "" ,
"reception_city" : "" ,
"reception_state" : null ,
"name" : "Isabella Magalhães" ,
"email" : "isahiroshima1999@gmail.com" ,
"mother_name" : "Andreia Magalhães" ,
"father_name" : "Sidney Cortiglio" ,
"partner_name" : "Murillo Augusto Moreira Bonamini" ,
"partner_email" : "" ,
"partner_mother_name" : "Andrea Bonamini" ,
"partner_father_name" : "Gilberto Bonamini" ,
"shipping_zipcode" : "37580-000" ,
"shipping_address" : "Rua Bahia" ,
"shipping_number" : "261" ,
"shipping_neighborhood" : "Magioli" ,
"shipping_complement" : "Loja" ,
"shipping_city" : "MONTE SIÃO" ,
"shipping_state" : "MG" ,
"shipping_date" : null ,
"shipping_description" : null ,
"user" : null
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 24 ,
"reference_code" : "" ,
"url" : "/lista/presente/isabella-magalhaes-e-murillo-augusto-moreira-bonamini/24/" ,
"type_list" : 4 ,
"customer" : 72 ,
"date" : "2018-12-29" ,
"state" : null ,
"city" : null ,
"guests" : null ,
"message" : null ,
"collection" : null ,
"notification" : true ,
"publish" : true ,
"status" : "A" ,
"ceremony_zipcode" : "" ,
"ceremony_address" : "" ,
"ceremony_number" : "" ,
"ceremony_neighborhood" : "" ,
"ceremony_complement" : "" ,
"ceremony_city" : "" ,
"ceremony_state" : null ,
"reception_zipcode" : "" ,
"reception_address" : "" ,
"reception_number" : "" ,
"reception_neighborhood" : "" ,
"reception_complement" : "" ,
"reception_city" : "" ,
"reception_state" : null ,
"name" : "Isabella Magalhães" ,
"email" : "isahiroshima1999@gmail.com" ,
"mother_name" : "Andreia Magalhães" ,
"father_name" : "Sidney Cortiglio" ,
"partner_name" : "Murillo Augusto Moreira Bonamini" ,
"partner_email" : "" ,
"partner_mother_name" : "Andrea Bonamini" ,
"partner_father_name" : "Gilberto Bonamini" ,
"shipping_zipcode" : "37580-000" ,
"shipping_address" : "Rua Bahia" ,
"shipping_number" : "261" ,
"shipping_neighborhood" : "Magioli" ,
"shipping_complement" : "Loja" ,
"shipping_city" : "MONTE SIÃO" ,
"shipping_state" : "MG" ,
"shipping_date" : null ,
"shipping_description" : null ,
"add_date" : "2018-07-02T17:05:26.448387" ,
"change_date" : "2018-07-02T17:21:02.975380" ,
"user" : null ,
"giftcard" : null ,
"gift_items" : []
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da lista
reference_code
Varchar
64
Código de referência
url
*
Text
-
URL da Lista de Presente (On-Line) gerado automaticamente
type_list
Int4
-
ID do Tipo da Lista
customer
Int4
-
ID do Cliente
date
Date
-
Data do Evento
state
Varchar
2
Estado do Evento
guests
Varchar
2
Número de Convidados
message
Text
Mensagem para os convidados que acessarem a sua lista
collection
Int4
-
ID da coleção, usado para lista pronta
notification
Boolean
1
Deseja receber informações sobre minha lista por e-mail
publish
Boolean
1
Deixar minha lista disponível no site
status
*
Varchar
2
Status da lista (A = Ativa, F = Finalizada, I = Inativa, E = Excluída), default = A
ceremony_zipcode
Varchar
9
CEP do Local da Cerimônia
ceremony_address
Varchar
150
Endereço do Local da Cerimônia
ceremony_number
Varchar
8
Número do Local da Cerimônia
ceremony_neighborhood
Varchar
120
Bairro do Local da Cerimônia
ceremony_complement
Varchar
255
Complemento do Local da Cerimônia
ceremony_city
Varchar
150
Cidade do Local da Cerimônia
ceremony_state
Varchar
2
Estado do Local da Cerimônia
reception_zipcode
Varchar
9
CEP do Local da Festa
reception_address
Varchar
150
Endereço do Local da Festa
reception_number
Varchar
8
Número do Local da Festa
reception_neighborhood
Varchar
120
Bairro do Local da Festa
reception_complement
Varchar
60
Complemento do Local da Festa
reception_city
Varchar
150
Cidade do Local da Festa
reception_state
Varchar
2
Estado do Local da Festa
name
Varchar
255
Nome do dono da Lista
email
Varchar
255
E-mail do dono da Lista
mother_name
Varchar
255
Nome da mãe do dono da Lista
father_name
Varchar
255
Nome do pai do dono da Lista
partner_name
Varchar
255
Nome do parceiro da Lista
partner_email
Varchar
255
E-mail do parceiro da Lista
partner_mother_name
Varchar
255
Nome da mãe do parceiro da Lista
partner_father_name
Varchar
255
Nome do pai do parceiro da Lista
shipping_zipcode
Varchar
9
CEP de Entrega
shipping_address
Varchar
150
Endereço de Entrega
shipping_number
Varchar
8
Número de Entrega
shipping_neighborhood
Varchar
120
Bairro de Entrega
shipping_complement
Varchar
60
Complemento de Entrega
shipping_city
Varchar
150
Cidade de Entrega
shipping_state
Varchar
2
Estado de Entrega
shipping_date
Date
-
Data de entrega
shipping_description
Text
Observação da entrega
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
user
Int4
-
ID do usuario, quando criado pela administração
giftcard
Int4
-
Dados do GiftCard, quando o pedido é entregue por vale. Gerado automaticamente
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/v2/giftlists/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/{ID}/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"reference_code" : "1234" ,
"type_list" : 4 ,
"customer" : 72 ,
"date" : "2018-12-29" ,
"state" : null ,
"city" : null ,
"guests" : null ,
"message" : null ,
"collection" : null ,
"notification" : true ,
"publish" : true ,
"status" : "A" ,
"ceremony_zipcode" : "" ,
"ceremony_address" : "" ,
"ceremony_number" : "" ,
"ceremony_neighborhood" : "" ,
"ceremony_complement" : "" ,
"ceremony_city" : "" ,
"ceremony_state" : null ,
"reception_zipcode" : "" ,
"reception_address" : "" ,
"reception_number" : "" ,
"reception_neighborhood" : "" ,
"reception_complement" : "" ,
"reception_city" : "" ,
"reception_state" : null ,
"name" : "Isabella Magalhães" ,
"email" : "isahiroshima1999@gmail.com" ,
"mother_name" : "Andreia Magalhães" ,
"father_name" : "Sidney Cortiglio" ,
"partner_name" : "Murillo Augusto Moreira Bonamini" ,
"partner_email" : "" ,
"partner_mother_name" : "Andrea Bonamini" ,
"partner_father_name" : "Gilberto Bonamini" ,
"shipping_zipcode" : "37580-000" ,
"shipping_address" : "Rua Bahia" ,
"shipping_number" : "261" ,
"shipping_neighborhood" : "Magioli" ,
"shipping_complement" : "Loja" ,
"shipping_city" : "MONTE SIÃO" ,
"shipping_state" : "MG" ,
"shipping_date" : null ,
"shipping_description" : null ,
"user" : null
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 24 ,
"reference_code" : "1234" ,
"url" : "/lista/presente/isabella-magalhaes-e-murillo-augusto-moreira-bonamini/24/" ,
"type_list" : 4 ,
"customer" : 72 ,
"date" : "2018-12-29" ,
"state" : null ,
"city" : null ,
"guests" : null ,
"message" : null ,
"collection" : null ,
"notification" : true ,
"publish" : true ,
"status" : "A" ,
"ceremony_zipcode" : "" ,
"ceremony_address" : "" ,
"ceremony_number" : "" ,
"ceremony_neighborhood" : "" ,
"ceremony_complement" : "" ,
"ceremony_city" : "" ,
"ceremony_state" : null ,
"reception_zipcode" : "" ,
"reception_address" : "" ,
"reception_number" : "" ,
"reception_neighborhood" : "" ,
"reception_complement" : "" ,
"reception_city" : "" ,
"reception_state" : null ,
"name" : "Isabella Magalhães" ,
"email" : "isahiroshima1999@gmail.com" ,
"mother_name" : "Andreia Magalhães" ,
"father_name" : "Sidney Cortiglio" ,
"partner_name" : "Murillo Augusto Moreira Bonamini" ,
"partner_email" : "" ,
"partner_mother_name" : "Andrea Bonamini" ,
"partner_father_name" : "Gilberto Bonamini" ,
"shipping_zipcode" : "37580-000" ,
"shipping_address" : "Rua Bahia" ,
"shipping_number" : "261" ,
"shipping_neighborhood" : "Magioli" ,
"shipping_complement" : "Loja" ,
"shipping_city" : "MONTE SIÃO" ,
"shipping_state" : "MG" ,
"shipping_date" : null ,
"shipping_description" : null ,
"add_date" : "2018-07-02T17:05:26.448387" ,
"change_date" : "2018-07-02T17:21:02.975380" ,
"user" : null ,
"giftcard" : null ,
"gift_items" : []
}
URL Parameters
Parameter
Description
ID
ID relativo a lista
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID da lista
reference_code
Varchar
64
Código de referência
url
*
Text
-
URL da Lista de Presente (On-Line) gerado automaticamente
type_list
Int4
-
ID do Tipo da Lista
customer
Int4
-
ID do Cliente
date
Date
-
Data do Evento
state
Varchar
2
Estado do Evento
guests
Varchar
2
Número de Convidados
message
Text
Mensagem para os convidados que acessarem a sua lista
collection
Int4
-
ID da coleção, usado para lista pronta
notification
Boolean
1
Deseja receber informações sobre minha lista por e-mail
publish
Boolean
1
Deixar minha lista disponível no site
status
*
Varchar
2
Status da lista (A = Ativa, F = Finalizada, I = Inativa, E = Excluída), default = A
ceremony_zipcode
Varchar
9
CEP do Local da Cerimônia
ceremony_address
Varchar
150
Endereço do Local da Cerimônia
ceremony_number
Varchar
8
Número do Local da Cerimônia
ceremony_neighborhood
Varchar
120
Bairro do Local da Cerimônia
ceremony_complement
Varchar
255
Complemento do Local da Cerimônia
ceremony_city
Varchar
150
Cidade do Local da Cerimônia
ceremony_state
Varchar
2
Estado do Local da Cerimônia
reception_zipcode
Varchar
9
CEP do Local da Festa
reception_address
Varchar
150
Endereço do Local da Festa
reception_number
Varchar
8
Número do Local da Festa
reception_neighborhood
Varchar
120
Bairro do Local da Festa
reception_complement
Varchar
60
Complemento do Local da Festa
reception_city
Varchar
150
Cidade do Local da Festa
reception_state
Varchar
2
Estado do Local da Festa
name
Varchar
255
Nome do dono da Lista
email
Varchar
255
E-mail do dono da Lista
mother_name
Varchar
255
Nome da mãe do dono da Lista
father_name
Varchar
255
Nome do pai do dono da Lista
partner_name
Varchar
255
Nome do parceiro da Lista
partner_email
Varchar
255
E-mail do parceiro da Lista
partner_mother_name
Varchar
255
Nome da mãe do parceiro da Lista
partner_father_name
Varchar
255
Nome do pai do parceiro da Lista
shipping_zipcode
Varchar
9
CEP de Entrega
shipping_address
Varchar
150
Endereço de Entrega
shipping_number
Varchar
8
Número de Entrega
shipping_neighborhood
Varchar
120
Bairro de Entrega
shipping_complement
Varchar
60
Complemento de Entrega
shipping_city
Varchar
150
Cidade de Entrega
shipping_state
Varchar
2
Estado de Entrega
shipping_date
Date
-
Data de entrega
shipping_description
Text
Observação da entrega
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
user
Int4
-
ID do usuario, quando criado pela administração
giftcard
Int4
-
Dados do GiftCard, quando o pedido é entregue por vale. Gerado automaticamente
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/v2/giftlists/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/giftlists/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/v2/giftlists/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo a lista
Vendedores - Televendas
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Lista
Lista de Vendedores
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/" );
var request = new RestRequest ( "/giftlists/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 6 ,
"next" : null ,
"previous" : null ,
"results" : [
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/v2/sellers/
Filtros via Query Parameters
Parameter
Description
id
ID da Lista
email
E-Mail
name
Nome
store
Tem ou Não Loja (true, false)
reference_code
Código de referência do vendedor
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/" );
var request = new RestRequest ( "/giftlists/{ID}/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Criação
HTTP Request
POST /{ENVIRONMENT}/api/v2/sellers/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/v2/sellers/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor
Vendedores - Mini Loja
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Mini Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
description
Text
-
Descrição do vendedor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
physical_store
Int4
-
ID da Loja Física
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Lista
Lista de Vendedores
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/" );
var request = new RestRequest ( "/giftlists/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 6 ,
"next" : null ,
"previous" : null ,
"results" : [
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/v2/sellers/
Filtros via Query Parameters
Parameter
Description
id
ID da Lista
email
E-Mail
name
Nome
store
Tem ou Não Loja (true, false)
reference_code
Código de referência do vendedor
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Mini Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
description
Text
-
Descrição do vendedor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
physical_store
Int4
-
ID da Loja Física
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/" );
var request = new RestRequest ( "/giftlists/{ID}/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Mini Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
description
Text
-
Descrição do vendedor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
physical_store
Int4
-
ID da Loja Física
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Criação
HTTP Request
POST /{ENVIRONMENT}/api/v2/sellers/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Mini Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
description
Text
-
Descrição do vendedor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
physical_store
Int4
-
ID da Loja Física
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Mini Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
description
Text
-
Descrição do vendedor
add_manual_value
*
Boolean
1
Pode adicionar valor manual
receive_mail
*
Boolean
1
Receber emails transacionais do pedido
view_only_own_budget
*
Boolean
1
Visualizar somente o próprio orçamento
reference_code
Varchar
64
Código de referência do vendedor
physical_store
Int4
-
ID da Loja Física
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/v2/sellers/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor
Vendedores - Marketplace
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
store_identification
Varchar
255
Nome de Identificação da Loja
logo_url
Varchar
255
Image com URL da Logo
description
Text
-
Descrição do vendedor
return_policy
Text
-
Política de Troca / Devolução
delivery_policy
Text
-
Política de Entrega
secutity_privacy_policy
Text
-
Política de Segurança e Privacidade
use_giftcard
*
Boolean
1
Informa se o vendedor pode usar giftcard como forma de pagamento (false, true)
product_commission
Numeric
10,2
Comissão em Produtos
freight_commission
Numeric
10,2
Comissão em Frete
fulfillment_endpoint
Varchar
255
URL do endpoint de Fullfillment
catalog_endpoint
Varchar
255
URL do endpoint de Catalogo
merchant_name
Varchar
150
Nome do Merchant usado no gateway para split de pagamento IMPLENTAÇÃO FUTURA
seller_Type
Varchar
15
Tipo de Vendedor (store = “Mini Loja / Afiliados Convertize”, convertize = “Convertize”, other = “Vendedor Remoto”)
is_full_store
*
Boolean
1
Idenfica se os produtos do vendedor pode ser vendido sem localização (false, true)
trust_policy
Varchar
15
Potica de Compartilhamento de dados (default = “Default”, emailsharing = “Envia o E-Mail do cliente, usado em B2B / B2B2C”)
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Lista
Lista de Vendedores
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/" );
var request = new RestRequest ( "/giftlists/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"count" : 6 ,
"next" : null ,
"previous" : null ,
"results" : [
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
]
}
HTTP Request
GET /{ENVIRONMENT}/api/v2/sellers/
Filtros via Query Parameters
Parameter
Description
id
ID da Lista
email
E-Mail
name
Nome
store
Tem ou Não Loja (true, false)
reference_code
Código de referência do vendedor
add_date__lte
Filtro por data de criação menor ou igual
add_date__gte
Filtro por data de criação maior ou igual
change_date__lte
Filtro por data de alteração menor ou igual
change_date__gte
Filtro por data de alteração maior ou igual
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
store_identification
Varchar
255
Nome de Identificação da Loja
logo_url
Varchar
255
Image com URL da Logo
description
Text
-
Descrição do vendedor
return_policy
Text
-
Política de Troca / Devolução
delivery_policy
Text
-
Política de Entrega
secutity_privacy_policy
Text
-
Política de Segurança e Privacidade
use_giftcard
*
Boolean
1
Informa se o vendedor pode usar giftcard como forma de pagamento (false, true)
product_commission
Numeric
10,2
Comissão em Produtos
freight_commission
Numeric
10,2
Comissão em Frete
fulfillment_endpoint
Varchar
255
URL do endpoint de Fullfillment
catalog_endpoint
Varchar
255
URL do endpoint de Catalogo
merchant_name
Varchar
150
Nome do Merchant usado no gateway para split de pagamento IMPLENTAÇÃO FUTURA
seller_Type
Varchar
15
Tipo de Vendedor (store = “Mini Loja / Afiliados Convertize”, convertize = “Convertize”, other = “Vendedor Remoto”)
is_full_store
*
Boolean
1
Idenfica se os produtos do vendedor pode ser vendido sem localização
trust_policy
Varchar
15
Potica de Compartilhamento de dados (default = “Default”, emailsharing = “Envia o E-Mail do cliente, usado em B2B / B2B2C”)
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Detalhes
HTTP Request
GET /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . get ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY
})
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/"
-H "Authorization: Token API_KEY"
using RestSharp ;
var client = new RestClient ( "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/" );
var request = new RestRequest ( "/giftlists/{ID}/" );
request . Method = Method . GET ;
request . AddHeader ( "Authorization" , "Token " + API_KEY );
var response = client . Execute ( request );
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
store_identification
Varchar
255
Nome de Identificação da Loja
logo_url
Varchar
255
Image com URL da Logo
description
Text
-
Descrição do vendedor
return_policy
Text
-
Política de Troca / Devolução
delivery_policy
Text
-
Política de Entrega
secutity_privacy_policy
Text
-
Política de Segurança e Privacidade
use_giftcard
*
Boolean
1
Informa se o vendedor pode usar giftcard como forma de pagamento (false, true)
product_commission
Numeric
10,2
Comissão em Produtos
freight_commission
Numeric
10,2
Comissão em Frete
fulfillment_endpoint
Varchar
255
URL do endpoint de Fullfillment
catalog_endpoint
Varchar
255
URL do endpoint de Catalogo
merchant_name
Varchar
150
Nome do Merchant usado no gateway para split de pagamento IMPLENTAÇÃO FUTURA
seller_Type
Varchar
15
Tipo de Vendedor (store = “Mini Loja / Afiliados Convertize”, convertize = “Convertize”, other = “Vendedor Remoto”)
is_full_store
*
Boolean
1
Idenfica se os produtos do vendedor pode ser vendido sem localização
trust_policy
Varchar
15
Potica de Compartilhamento de dados (default = “Default”, emailsharing = “Envia o E-Mail do cliente, usado em B2B / B2B2C”)
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Criação
HTTP Request
POST /{ENVIRONMENT}/api/v2/sellers/
import requests
r = requests . post ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X POST -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
store_identification
Varchar
255
Nome de Identificação da Loja
logo_url
Varchar
255
Image com URL da Logo
description
Text
-
Descrição do vendedor
return_policy
Text
-
Política de Troca / Devolução
delivery_policy
Text
-
Política de Entrega
secutity_privacy_policy
Text
-
Política de Segurança e Privacidade
use_giftcard
*
Boolean
1
Informa se o vendedor pode usar giftcard como forma de pagamento (false, true)
product_commission
Numeric
10,2
Comissão em Produtos
freight_commission
Numeric
10,2
Comissão em Frete
fulfillment_endpoint
Varchar
255
URL do endpoint de Fullfillment
catalog_endpoint
Varchar
255
URL do endpoint de Catalogo
merchant_name
Varchar
150
Nome do Merchant usado no gateway para split de pagamento IMPLENTAÇÃO FUTURA
seller_Type
Varchar
15
Tipo de Vendedor (store = “Mini Loja / Afiliados Convertize”, convertize = “Convertize”, other = “Vendedor Remoto”)
is_full_store
*
Boolean
1
Idenfica se os produtos do vendedor pode ser vendido sem localização
trust_policy
Varchar
15
Potica de Compartilhamento de dados (default = “Default”, emailsharing = “Envia o E-Mail do cliente, usado em B2B / B2B2C”)
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Alteração
HTTP Request
PUT /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . put ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
'Content-Type' : 'application/json'
}, data =< JSON > )
print r . status_code
print r . json ()
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/"
-H "Authorization: Token API_KEY"
-H "Content-Type: application/json"
-X PUT -d '<JSON>'
Exemplo < JSON > a ser enviado:
{
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
O comando acima retonar um JSON conforme estrutura abaixo:
{
"id" : 11 ,
"name" : "Teste - Marketlace" ,
"email" : "dev@convertize.com.br" ,
"group" : null ,
"blocked" : false ,
"reference_code" : null ,
"supervisor" : null ,
"add_manual_value" : false ,
"receive_mail" : false ,
"view_only_own_budget" : true ,
"image" : null ,
"store" : true ,
"url" : "teste" ,
"description" : "teste d" ,
"phone" : "" ,
"sales" : 0 ,
"physical_store" : null ,
"seller_Type" : "other" ,
"store_identification" : "Dev - Marketplace" ,
"logo_url" : null ,
"return_policy" : "teste p" ,
"delivery_policy" : "teste e" ,
"secutity_privacy_policy" : "teste pp" ,
"use_giftcard" : false ,
"product_commission" : "0.00" ,
"freight_commission" : "0.00" ,
"fulfillment_endpoint" : null ,
"catalog_endpoint" : null ,
"merchant_name" : null ,
"is_full_store" : false ,
"trust_policy" : "default" ,
"add_date" : "2022-02-28T21:43:50.032027" ,
"change_date" : "2022-02-28T22:31:07.816413" ,
"extra_data" : null
}
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor
Descrição dos campos
Campo
Requerido
Unico
Tipo do Campo
Max Caracteres
Descrição
id
*
Int4
-
ID do pedido
name
*
Varchar
255
Nome
url
*
Varchar
255
URL da Loja
document
*
Varchar
15
Documento CPF/CNPJ
email
*
*
Varchar
255
E-Mail
password
Varchar
255
Quanto não NULO, o sistema vai gerar um senha e um ambiente de acesso para o vendedor
group
Int4
-
ID do Grupo
blocked
*
Boolean
1
Informa se o item é presente (false, true)
supervisor
Int4
-
ID do Vendedor Supervisor
store
*
Boolean
1
Informa se o vendedor tem loja ou não (false, true)
store_identification
Varchar
255
Nome de Identificação da Loja
logo_url
Varchar
255
Image com URL da Logo
description
Text
-
Descrição do vendedor
return_policy
Text
-
Política de Troca / Devolução
delivery_policy
Text
-
Política de Entrega
secutity_privacy_policy
Text
-
Política de Segurança e Privacidade
use_giftcard
*
Boolean
1
Informa se o vendedor pode usar giftcard como forma de pagamento (false, true)
product_commission
Numeric
10,2
Comissão em Produtos
freight_commission
Numeric
10,2
Comissão em Frete
fulfillment_endpoint
Varchar
255
URL do endpoint de Fullfillment
catalog_endpoint
Varchar
255
URL do endpoint de Catalogo
merchant_name
Varchar
150
Nome do Merchant usado no gateway para split de pagamento IMPLENTAÇÃO FUTURA
seller_Type
Varchar
15
Tipo de Vendedor (store = “Mini Loja / Afiliados Convertize”, convertize = “Convertize”, other = “Vendedor Remoto”)
is_full_store
*
Boolean
1
Idenfica se os produtos do vendedor pode ser vendido sem localização
trust_policy
Varchar
15
Potica de Compartilhamento de dados (default = “Default”, emailsharing = “Envia o E-Mail do cliente, usado em B2B / B2B2C”)
extra_data
JSON
JSON com qualquer extra data
add_date
Date
-
Data de criação
change_date
Date
-
Data de alteração
Delete
HTTP Request
DELETE /{ENVIRONMENT}/api/v2/sellers/{ID}/
import requests
r = requests . delete ( 'https://api.convertize.com.br/{ENVIRONMENT}/api/v2/sellers/{ID}/' , headers = {
'Authorization' : 'Token % s' % API_KEY ,
})
print r . status_code
print r . json ()
curl -X DELETE \
https://api.convertize.com.br/{ ENVIRONMENT} /api/v2/sellers/{ ID} / \
-H 'Authorization: Token API_KEY'
O comando acima retonar um HTTP STATUS:
Http Status: 204
URL Parameters
Parameter
Description
ID
ID relativo ao vendedor