Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Documentação para acessar API da CliqueRetire
O Objetivo dessa documentação é apresentar de maneira rápida e objetiva como desenvolver uma integração com a Clique Retire. Os serviços disponíveis em nossa API estão exibidos no menu a esquerda e descrição de cada parâmetro assim como exemplos de uso estão disponiveís internamente em cada item.
Está API utiliza requisições HTTP GET, POST, DELETE e o formato JSON para transferência de dados
Code
Description
400
Parameter error
401
UserToken expired or Invalid
403
User does not have permission
404
Resource not found
409
Conflict or already exists
500
Server error
Recursos relacionados a volumes.
GET
https://services.cliqueretire.com.br/ebox/api/v1/volumes
Listar volumes cadastrados
GET
https://services.cliqueretire.com.br/ebox/api/v1/volumes_by_expressNumber/:expressNumber
Busca informações de um volume utilizando o código da etiqueta
DELETE
https://services.cliqueretire.com.br/ebox/api/v1/volumes
Cancela um volume através de seu expressNumber
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Content-Type
string
application/json
api-id
string
api-key
string
appllication/
expressNumber
string
Código da etiqueta do pacote
Content-Type
string
application/json
api-id
string
api-key
string
expressNumber
string
Código da etiqueta do pacote
Content-Type
string
application/json
api-id
string
api-key
string
Content-Type | string | application/json |
api-id | string |
api-key | string |
data | array | Informação dos pacotes |
type | string | Tipo dos pacotes. DELIVERYou RETURN |
Field | Description |
name | Nome do usuário |
barCode | Código de barras do volume |
phoneNumber | Telefone celular do usuário |
boxAddress | Endereço do E-BOX |
boxZipCode | CEP do E-BOX |
boxCode | Código único do E-BOX |
createTime | Data de geração |
logisticsCompany | Nome da empresa |
Como receber atualizações do tracking de volumes através do webhook Clique Retire
POST
https://sua-url.com/
Esse recurso trata-se de um Webhook que oferece o envio de informações relacionadas aos eventos de rastreamento para sistemas terceiros integrados. A URL para o recebimento do evento precisa ser informada no momento da criação do pedido ou através do nosso canal de suporte. Todos os eventos enviados são sempre relacionados a 1 (um) volume.
Recursos relacionados aos E-BOX
POST
https://services.cliqueretire.com.br/ebox/api/v1/lockers/check_volume_fits
Essa consulta pode ser utilizada pelo embarcador no momento em que os produtos estão no carrinho de compras para verificação da compatibilidade entre o tamanho dos pacotes e o tamanho suportado pelos compartimentos do Locker para receber o produto.
Informações do volume (*)Required
GET
https://services.cliqueretire.com.br/ebox/api/v1/lockers/site
Recursos público para consulta de listagem de E-BOX disponíveis na rede Clique Retire
GET
https://services.cliqueretire.com.br/ebox/api/v1/lockers/export/csv
Recurso público para consulta de listagem de E-BOX disponíveis na rede Clique Retire no formato CSV.
GET
https://services.cliqueretire.com.br/ebox/api/v1/lockers/boxCode/:boxCode
Informações do E-BOX e de seus compartimentos
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
expressNumber
string
Código de barras do volume
eventTimeStamp
integer
Data de ocorrência do evento
accessCode
string
Código para retirar o volume do E-BOX
shortLink
string
Link contendo o QR Code para retirar o volume do E-BOX
overdueTimeStamp
integer
Data de expiração do volume no E-BOX
customer
string
Usuário final
boxCode
string
Código único do E-BOX
event
string
Evento
Fields
Description
ORIGIN_COLLECTED
Coletado no centro de distribuição do embarcador
CARRIER_DISTRIBUTION_CENTER
No centro de distruibuição da transportadora
FOR_MERCHANT_STORE_IN_BOUND
No centro de distribuição Clique Retire
FOR_MERCHANT_STORE_IN_TRANSIT_TO_STORE
A caminho do E-BOX
FOR_MERCHANT_STORE_IN_STORE
Inserido no E-BOX
FOR_MERCHANT_STORE_COURIER_TAKEN
Volume expirado, coletado pela transportadora
FOR_MERCHANT_STORE_COURIER_TAKEN_IN_BOUND
Volume expirado, coletado pela transportadora, retornado para o centro de distribuição Clique Retire
FOR_MERCHANT_STORE_CUSTOMER_TAKEN
Volume coletado pelo usuário
FOR_MERCHANT_STORE_IN_STORE_EXPIRED
Tempo do volume no E-BOX expirado
FOR_MERCHANT_STORE_IN_STORE_UPCOMING_EXPIRED
Tempo do volume no E-BOX prestes a expirar
FOR_CUSTOMER_STORE_IN_STORE
Inserido no E-BOX pelo usuário. (Logística Reversa)
FOR_CUSTOMER_STORE_COURIER_TAKEN
Coletado no E-BOX pela transportadora (Logística Reversa)
FOR_CUSTOMER_STORE_IN_BOUND
No centro de distribuição Clique Retire
Fields
Description
cellPhone
Celular do usuário
Email do usuário
Content-Type
string
application/json
api-id
string
string
api-key
string
string
boxCode
string
Código do E-BOX
volumes
array
Volumes que deseja consultar compatibilidade com o locker
Field
Description
externalId
Id para Referência do volume no sistema do embarcador
width*
Largura do volume em cm
heigth*
Altura do volume em cm
depth*
Profundidade do volume em cm
Content-Type
string
application/json
Content-Type
string
application/json
boxCode
string
Código único do E-BOX
Content-Type
string
application/json
api-id
string
api-key
string
Como atualizar a Clique Retire a respeito de algum evento ocorrido no processo.
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Content-Type
string
application/json
api-id
string
api-key
string
expressNumber
string
Código da etiqueta do pacote
statusTimestamp
integer
Data de ocorrência do evento no formato timestamp
event
string
Evento relacionado a ocorrência do tipo ENUM conforme tabela Eventos Disponíveis.
Events
Description
ORIGIN_COLLECTED
Coletado no centro de distribuição do embarcador
CARRIER_DISTRIBUTION_CENTER
No centro de distruibuição da transportadora
FOR_MERCHANT_STORE_IN_BOUND
No centro de distribuição Clique Retire
FOR_MERCHANT_STORE_IN_TRANSIT_TO_STORE
A caminho do E-BOX
FOR_MERCHANT_STORE_IN_STORE
Inserido no E-BOX
FOR_MERCHANT_STORE_COURIER_TAKEN
Volume expirado, coletado pela transportadora
FOR_MERCHANT_STORE_COURIER_TAKEN_IN_BOUND
Volume expirado, coletado pela transportadora, retornado para o centro de distribuição Clique Retire
FOR_MERCHANT_STORE_CUSTOMER_TAKEN
Volume coletado pelo usuário
FOR_MERCHANT_STORE_IN_STORE_EXPIRED
Tempo do volume no E-BOX expirado
FOR_MERCHANT_STORE_IN_STORE_UPCOMING_EXPIRED
Tempo do volume no E-BOX prestes a expirar
FOR_CUSTOMER_STORE_IN_STORE
Inserido no E-BOX pelo usuário. (Logística Reversa)
FOR_CUSTOMER_STORE_COURIER_TAKEN
Coletado no E-BOX pela transportadora (Logística Reversa)
FOR_CUSTOMER_STORE_IN_BOUND
No centro de distribuição Clique Retire
Content-Type
string
application/json
api-id
string
api-key
string
string
origin_city
string
Cidade de Origem
origin_name
string
Razão social empresa
origin_state_code
string
UF
origin_state_tax_payer_id
string
Inscrição estadual
origin_street
string
Endereço e número
origin_zip_code
string
CEP
shipment_date
string
Data de coleta
shipment_order_array
array
Array de pedidos
Fields
Description
externalId
Identificador do pedido do embarcador
boxCode
Código único do E-BOX
customer
Objeto com informações do usuário
shipment_order_volume_array
Array com volumes
Fields
Descripton
cellphone
5521999999999
barackobama@gmal.com
Field
Description
height
Altura
length
Comprimento
weight
Peso
width
Largura
shipment_order_volume_number
Código de barras do pacote
shipment_order_volume_invoice_array
Array nota fiscal
Field
Description
already_insured
Carga assegurado (bool)
cubage
Cubagem
icms_aliquot
Alíquota icms
icms_calculation_basis
Base de cálculo icms
invoice_cfop
CFOP Nota fiscal
invoice_date_iso
Data emissão nota fiscal(DDMMYYYY)
invoice_key
Chave nota fiscal
invoice_nature
Natureza nota fiscal
invoice_number
Número nota fiscal
invoice_products_value
Valor dos produtos na nota fiscal
invoice_series
Série da nota fiscal
Recursos relacionados a pedidos, entidade que agrupa volumes.
GET
https://services.cliqueretire.com.br/ebox/api/v1/orders
Lista pedidos
GET
https://services.cliqueretire.com.br/ebox/api/v1/orders/:id
Busca informações de um pedido, utilizando o id do pedido.
POST
https://services.cliqueretire.com.br/ebox/api/v1/orders
Cria um pedido com seus pacotes
Informações do destinatário. (*) Required
Informações do volume (*)Required
Informações da nota fiscal (*)Required
POST
https://services.cliqueretire.com.br/ebox/api/v1/orders/return
Criação de pedidos com volumes para logística reversa.
Informações do destinatário. (*) Required
Informações do volume (*)Required
Informações da nota fiscal
DELETE
https://services.cliqueretire.com.br/ebox/api/v1/orders/:id
Deleta um pedido
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Name | Type | Description |
---|
Authorization
string
origin_city
string
Cidade de origem
origin_name
string
Razão social empresa
origin_state_code
string
UF
origin_state_tax_payer_id
string
Inscrição estadual
origin_street
string
Endereço e número
origin_zip_code
string
CEP
shipment_date
string
Data de coleta
shipment_order_array
string
Array de pedidos
Field
Description
externalId
Identificador do pedido do embarcador
boxCode
Código único do E-BOX
customer
Objeto com informações do usuário
shipment_order_volume_array
Array com volumes
Field
Descripti
cellphone
5521999999999
barackobama@gmal.com
Field
Description
height
Altura
length
Comprimento
weight
Peso
width
Largura
shipment_order_volume_number
Código de barras do pacote
shipment_order_volume_invoice_array
Array nota fiscal
Field
Description
already_insured
Carga assegurado (bool)
cubage
Cubagem
icms_aliquot
Alíquota icms
icms_calculation_basis
Base de cálculo icms
invoice_cfop
CFOP Nota fiscal
invoice_date_iso
Data emissão nota fiscal(DDMMYYYY)
invoice_key
Chave nota fiscal
invoice_nature
Natureza nota fiscal
invoice_number
Número nota fiscal
invoice_products_value
Valor dos produtos na nota fiscal
invoice_series
Série da nota fiscal
Content-Type | string | application/json |
api-id | string |
api-key | string |
id | string | Id do pedido |
Content-Type | string | application/json |
api-id | string |
api-key | string |
Content-Type | string | application/json |
api-id | string |
api-key | string |
invoice | object | Objeto com dados da nota fiscal |
externalId | string | Identificador do pedido do embarcador |
customer | object | Informações do destinatário |
boxCode | string | Código do E-BOX |
volumes | array | Volumes associados a esse pedido |
urlCallback | string | URL para qual o webHook irá disparar os eventos relacionados ao pedido |
Field | Description |
cellphone* | Telefone do destinatário (5521999999999) |
email* | string |
fullName | string |
documentNumber | string |
Field | Description |
expressNumber* | Código de barras do pacote |
designationSize | ENUM ["S", "M", "L"] |
externalId | string |
Field | Description |
series | Número de série da nota fiscal |
number | Número da nota fiscal |
key | Chave da nota fiscal |
date | Data de emissão da nota fiscal |
dateIso | Data de emissão da nota fiscal formato ISO |
totalValue | Valor total da nota fiscal |
productsValue | Valor total dos produtos |
insured | Produto assegurado |
Application-Type | string | application/json |
api-id | string | string |
api-key | string | string |
invoice | string | Objeto com dados da nota fiscal |
externalId | string | Identificador do pedido do embarcador |
customer | string | Informações do destinatário |
boxCode | string | Código do E-BOX |
volumes | string | Volumes associados a esse pedido |
urlCallback | string | URL para qual o webhook irá disparar eventos relacionados aos pedidos |
Field | Description |
cellphone* | Telefone do destinatário (5521999999999) |
email* | string |
fullName | string |
documentNumber | string |
Field | Description |
expressNumber* | Código de barras do pacote |
designationSize | ENUM ["S", "M", "L"] |
externalId | string |
Field | Description |
series | Número de série da nota fiscal |
number | Número da nota fiscal |
key | Chave da nota fiscal |
date | Data de emissão da nota fiscal |
dateIso | Data de emissão da nota fiscal formato ISO |
totalValue | Valor total da nota fiscal |
productsValue | Valor total dos produtos |
insured | Produto assegurado |
id | string | Id do pedido |
Content-Type | string | application/json |
api-id | string | string |
api-key | string | string |