Configurações

Credenciais da loja

Listar credenciais

GET https://api.dooki.com.br/v2/{alias}/config/merchant-credentials

Request de credenciais

{
"active": true,
"is_subdomain": true,
"domain": "domain.com.br",
}

Response de credenciais

{
"data": {
"id": 3,
"active": true,
"is_subdomain": false,
"alias": "merchant_alias",
"domain": "domain.com.br",
}
}

Parâmetro

Tipo

Obrigatório

Descrição

active

boolean

Sim

Status da loja.

is_subdomain

boolean

Sim

Marca se a loja roda em um subdomínio.

domain

string

Sim

Domínio da loja.

Atualizar credenciais

PUT https://api.dooki.com.br/v2/{alias}/config/merchant-credentials/{id}

Dados da loja

Listar dados da loja

GET https://api.dooki.com.br/v2/{alias}/config/merchant-data

Request de dados da loja

{
"maintenance": false,
"name": "Merchant Name",
"razao_social": "Razao Social",
"email_contact": "merchant@domain.com",
"email_sales": "merchant@domain.com",
"description": "Merchant Description",
"owner_name": "John Snow",
"phone": "99 9999999",
"whatsapp": "99 9999999",
"ie": "0000",
"cnpj": "00.000.0000/0001-32",
"cpf" : null,
"full_address": "Address Store",
"zipcode": "14940000",
"products_per_page": 10,
"logo_url": "http://url.to/logo.jpg",
"icon_url": "http://url.to/logo.jpg",
"facebook_url": null,
"instagram_url": null,
"youtube_url": null,
"pinterest_url": null
}

Response de dados da loja

{
"data": {
"id": 9,
"maintenance": false,
"type": "j",
"name": "Loja de Teste",
"razao_social": "aaaaa",
"email_contact": "email@email.com.br",
"email_sales": "email@email.com.br",
"description": "description",
"owner_name": "Owner",
"phone": "(12) 31131-3131",
"whatsapp": null,
"ie": "a",
"cnpj": "31.903.676/0001-19",
"cpf": null,
"full_address": ", - ",
"address_street": null,
"address_number": null,
"address_complement": null,
"address_neighborhood": null,
"address_city": "Ibitinga",
"address_state": "SP",
"zipcode": "14940-000",
"billing_document_type": "j",
"billing_name": "Mimi Enxovais",
"billing_document": "31.903.676/0001-19",
"products_per_page": 15,
"logo_url": "https://s3.amazonaws.com/images.yampi.me/assets/stores/mimienxovais/uploads/logo/mimienxovais.png",
"icon_url": "https://s3.amazonaws.com/images.yampi.me/assets/stores/mimienxovais/uploads/icon/apple-touch-icon-iphone-retina.png",
"facebook_url": null,
"instagram_url": null,
"youtube_url": null,
"pinterest_url": null
}
}

Atualizar dados da loja

PUT https://api.dooki.com.br/v2/{alias}/config/merchant-data/{id}

Parâmetro

Tipo

Obrigatório

Descrição

maintenance

boolean

Sim

Marca se a loja está em manutenção.

name

string

Sim

Nome da loja.

description

string

Sim

Descrição da loja.

razao_social

string

Não

Razão social da loja.

email_contact

string

Sim

E-mail de contato da loja.

email_sales

string

Sim

E-mail de vendas da loja.

owner_name

string

Sim

Nome do proprietário da loja.

phone

string

Não

Telefone da loja.

whatsapp

string

Não

Whatsapp da loja.

ie

string

Não

Inscrição Estadual da loja.

cnpj

string

Não

CNPJ da loja.

cpf

string

Não

CPF do proprietário.

full_address

string

Não

Endereço da loja.

address_street

string

Sim

Rua da loja.

address_number

string

Sim

Número da loja.

address_complement

string

Não

Complemento da loja.

address_neighborhood

string

Sim

Bairro da loja.

address_city

string

Sim

Cidade da loja.

address_state

string

Sim

Estado da loja.

zipcode

string

Sim

CEP da loja.

products_per_page

int

Sim

Números de produtos por página.

logo_url

string

Não

URL do logotipo da loja.

icon_url

string

Não

URL do ícone da loja.

facebook_url

string

não

URL do facebook da loja da loja.

instagram_url

string

não

URL do instagram da loja.

youtube_url

string

não

URL do youtube da loja.

pinterest_url

string

não

URL do pinterest da loja.

Checkout (config)

Listar configuração do checkout

GET https://api.dooki.com.br/v2/{alias}/config/checkout

Request de configuração do checkout

{
"sequential_sale_number": true,
"delivery_working_days": true,
"show_shipping_in_cart": true,
"show_products_links": true,
"show_promocode": true,
"max_daily_sales_by_ip": 3,
"currency": "R$",
"person_type": "all",
"text_footer": null,
"text_shipping": "O prazo de entrega começa a contar apenas quando o pagamento for confirmado",
"text_billet": null,
"text_card": null,
"redirect_url_billet": null,
"redirect_url_card": null,
"redirect_url_deposit": null
}

Response de dados da loja

{
"data": {
"id": 1,
"sequential_sale_number": true,
"delivery_working_days": true,
"show_shipping_in_cart": true,
"show_products_links": true,
"show_promocode": true,
"max_daily_sales_by_ip": 3,
"currency": "R$",
"text_footer": null,
"person_type": "all",
"text_shipping": "O prazo de entrega começa a contar apenas quando o pagamento for confirmado",
"text_billet": null,
"text_card": null,
"text_deposit": null,
"redirect_url_billet": null,
"redirect_url_card": null,
"redirect_url_deposit": null
}
}

Atualizar configuração de checkout

PUT https://api.dooki.com.br/v2/{alias}/config/checkout/{id}

Parâmetro

Tipo

Obrigatório

Descrição

sequential_sale_number

boolean

Sim

Marca se os números dos pedidos serão sequenciais.

delivery_working_days

boolean

Sim

Marca se o prazo de entrega será em dias úteis.

show_shipping_in_cart

boolean

Sim

Marca se o cálculo de frete no carrinho estará visível.

show_products_links

boolean

Sim

Marca se os produtos no carrinho terão links.

show_promocode

boolean

Sim

Marca se os campo de cupom de desconto será visível.

max_daily_sales_by_ip

int

Sim

Máximo de pedidos por dia por IP. Mínimo: 3.

currency

string

Sim

Moeda monetária. Valores aceitos: R$.

person_type

string

Não

Tipos de cadastro aceitos. Valores: all, business e personal

text_footer

string

Não

Texto no rodapé do checkout.

text_shipping

string

Não

Texto de apoio para entregas.

text_billet

string

Não

Texto de apoio para boleto bancário.

text_card

string

Não

Texto de apoio para cartão de crédito.

text_deposit

string

Não

Texto de apoio para depósito.

redirect_url_billet

string

Não

URL de redirecionamento quando o pagamento for por boleto bancário.

redirect_url_card

string

Não

URL de redirecionamento quando o pagamento for por cartão de crédito.

redirect_url_deposit

string

Não

URL de redirecionamento quando o pagamento for por depósito.

IPS bloqueados

Listar IPS bloqueados

GET https://api.dooki.com.br/v2/{alias}/config/blocked-ips

Request

{
"ip": "127.0.0.1",
}

Response

{
"data": [
{
"id": 1,
"name": "127.0.0.1",
},
]
}

Criar bloqueio de IP

POST https://api.dooki.com.br/v2/{alias}/config/blocked-ips

Parâmetro

Tipo

Obrigatório

Descrição

ip

string

Sim

Número de IP.

Visualizar bloqueio de IP

GET https://api.dooki.com.br/v2/{alias}/config/blocked-ips/{id}

Atualizar bloqueio de IP

PUT https://api.dooki.com.br/v2/{alias}/config/blocked-ips/{id}

Excluir bloqueio de IP

DELETE https://api.dooki.com.br/v2/{alias}/config/blocked-ips/{id}

Carrinhos abandonados (config)

A plataforma possui um recurso de disparo automático de e-mails de recuperação de carrinho.

Listar configurações de carrinhos abandonados

GET https://api.dooki.com.br/v2/{alias}/config/carts

Request

{
"email_subject": "{name}, os produtos estão te esperando!",
"sms_subject": "{name}, os produtos estão te esperando!",
"email_frequency": 1,
"email_hours_delay": 1,
"promocode_in_first_email": false
}

Response

{
"data": [
{
"id": 1,
"email_subject": "{name}, os produtos estão te esperando!",
"sms_subject": "{name}, os produtos estão te esperando!",
"email_frequency": 1,
"email_hours_delay": 1,
"promocode_in_first_email": false
},
]
}

Criar configuração de carrinho abandonado

POST https://api.dooki.com.br/v2/{alias}/config/carts

Só é permitida uma configuração de carrinho abandonado.

Parâmetro

Tipo

Obrigatório

Descrição

email_subject

string

Sim

Assunto do e-mail de recuperação. Você pode usar a tag {name} que o sistema substituirá pelo nome do cliente.

sms_subject

string

Não

Mensagem customizada do SMS.

email_frequency

int

Sim

Número de dias que o sistema enviará o e-mail. Máximo: 2.

email_hours_delay

int

Sim

Atraso (em horas) para o primeiro disparo. Padrão: 1.

promocode_in_first_email

boolean

Sim

Marca se o sistema deve enviar o cupom de desconto associado no primeiro e-mail.

Visualizar configuração de carrinho abandonado

GET https://api.dooki.com.br/v2/{alias}/config/carts/{id}

Atualizar configuração de carrinho abandonado

PUT https://api.dooki.com.br/v2/{alias}/config/carts/{id}

Excluir configuração de carrinho abandonado

DELETE https://api.dooki.com.br/v2/{alias}/config/carts/{id}

Integrações

Só é permitida uma configuração por serviço.

Includes disponíveis: config, form

Listar todas os serviços disponíveis

GET https://api.dooki.com.br/v2/{alias}/config/services

Visualizar serviço

GET https://api.dooki.com.br/v2/{alias}/config/services/{service}

Filtros personalizados

Esse tipo de filtro não utiliza a sintaxe global. Neste caso, o parâmetro é passado individualmente via query string na URL.

Parâmetro

Tipo

Descrição

groupedByCategory

boolean

Agrupa os serviços de acordo com suas categorias

Listar todos os serviços com configurações ativas

GET https://api.dooki.com.br/v2/{alias}/config/services?actives=true

Response de todos os serviços

{
"data": [
{
"alias": "clearsale_form",
"name": "Clearsale Form",
"category": "antifraud",
"active_config": true,
"params": {
"data": [
"env",
"code"
]
}
},
{
"alias": "clearsale_total",
"name": "Clearsale Total",
"category": "antifraud",
"active_config": false,
"params": {
"data": [
"env",
"entity_code",
"app_fingerprint"
]
}
},
]
}

Listar configuração de um serviço

GET https://api.dooki.com.br/v2/{alias}/config/services/{serviceAlias}/settings

Criar nova configuração para um serviço

POST https://api.dooki.com.br/v2/{alias}/config/services/{serviceAlias}/settings

Request para criar ou atualizar uma configuração

{
"active": true,
"service_alias": "intelipost",
"params": {
"origin_zipcode": "14940000",
"api_key": "api_key"
}
}

Response de configuração de serviço

{
"data": [
{
"id": 33,
"service_alias": "intelipost",
"active": true,
"params": {
"origin_zipcode": "14940000",
"api_key": "api_key"
},
}
],
}

Atualizar configuração de um serviço

PUT https://api.dooki.com.br/v2/{alias}/config/services/{serviceAlias}/settings/{id}

Excluir configuração de um serviço

DELETE https://api.dooki.com.br/v2/{alias}/config/services/{serviceAlias}/settings/{id}

Fotos

Listar configurações de fotos

GET https://api.dooki.com.br/v2/{alias}/config/photos

Request

{
"width_small": 50,
"height_small": 50,
"width_thumb": 100,
"height_thumb": 100,
"width_medium": 500,
"height_medium": 500,
"width_large": 1000,
"height_large": 1000
}

Response

{
"data": [
{
"id": 1,
"width_small": 50,
"height_small": 50,
"width_thumb": 100,
"height_thumb": 100,
"width_medium": 500,
"height_medium": 500,
"width_large": 1000,
"height_large": 1000
},
]
}

Criar configuração de foto

POST https://api.dooki.com.br/v2/{alias}/config/photos

Só é permitida uma configuração de foto.

Parâmetro

Tipo

Obrigatório

Descrição

width_small

int

Sim

Largura da foto small.

height_small

int

Sim

Altura da foto small.

width_thumb

int

Sim

Largura da foto thumb.

height_thumb

int

Sim

Altura da foto thumb.

width_medium

int

Sim

Largura da foto medium.

height_medium

int

Sim

Altura da foto medium.

width_large

int

Sim

Largura da foto large.

height_large

int

Sim

Altura da foto large.

Visualizar configuração de foto

GET https://api.dooki.com.br/v2/{alias}/config/photos/{id}

Atualizar configuração de foto

PUT https://api.dooki.com.br/v2/{alias}/config/photos/{id}

Excluir configuração de foto

DELETE https://api.dooki.com.br/v2/{alias}/config/photos/{id}

E-mails

Listar configurações de e-mails

GET https://api.dooki.com.br/v2/{alias}/config/emails

Request

{
"host": "smtp.server.com",
"username": "username@server.com",
"password": "123456",
"encryption": "ssl",
"port": 465,
"from": "contact@server.com",
"name": "Merchant Name"
}

Response

{
"data": [
{
"id": 1,
"host": "smtp.server.com",
"username": "username@server.com",
"password": "123456",
"encryption": "ssl",
"port": 465,
"from": "contact@server.com",
"name": "Merchant Name"
},
]
}

Criar configuração de email

POST https://api.dooki.com.br/v2/{alias}/config/emails

Só é permitida uma configuração de e-mail.

Parâmetro

Tipo

Obrigatório

Descrição

host

string

Sim

Servidor de saída.

username

string

Sim

Usuário de autenticação.

password

string

Sim

Senha de autenticação.

encryption

string

Sim

Tipo de criptografia.

port

int

Sim

Porta de saída.

from

string

Sim

E-mail do remetente das mensagens.

name

string

Sim

Nome do remetente das mensagens.

Visualizar configuração de email

GET https://api.dooki.com.br/v2/{alias}/config/emails/{id}

Atualizar configuração de email

PUT https://api.dooki.com.br/v2/{alias}/config/emails/{id}

Excluir configuração de email

DELETE https://api.dooki.com.br/v2/{alias}/config/emails/{id}

Overview

Overview geral das configuracões essenciais para o funcionamento correto da loja

GET https://api.dooki.com.br/v2/{alias}/config/overview

Response

{
"data": [
{
"title": "Cadastre uma planilha de frete",
"message": "Baixe nossa planilha modelo, atualize os valores e cadastre na plataforma. Mesmo que você tenha uma integração, aconselhamos você cadastrar uma planilha de frete como backup.",
"icon": "carrier",
"url": "http://king.test/config/logistics"
},
{
"title": "Cadastre informações sobre sua loja",
"message": "E-mail, razão social, CNPJ, descrição da loja e endereço são itens essenciais para mecanismos de busca como o Google e também para disponibilizar a seus clientes.",
"icon": "store-config",
"url": "http://king.testconfig/merchant-data/edit"
}
],
}