Zenkraft (versão prévia)
Conecta-se à API zenkraft para criar/gerenciar/acompanhar remessas de mais de 50 operadoras diferentes
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte do Zenkraft |
| URL | https://zenkraft.com/docs |
| support@zenkraft.com |
| Metadados do conector | |
|---|---|
| Publicador | Zenkraft |
| Site | https://zenkraft.com/ |
| Política de privacidade | https://zenkraft.com/privacy-policy |
| Categorias | Comércio; Vendas e CRM |
A API de envio da Zenkraft foi projetada para facilitar a taxação, a reserva, o rastreamento e o agendamento de retiradas com uma lista crescente de transportadoras.
Pré-requisitos
Você precisará de uma assinatura paga para acessar a API zenkraft. Entre em contato sales@zenkraft.com
Problemas e limitações conhecidos
Se houver um problema com o serviço Web de uma operadora, nosso conector retornará uma mensagem de erro
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API do Zenkraft | secureString | A chave de API do Zenkraft para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Acompanhar a remessa |
Rastreia uma remessa com uma transportadora e retorna os pontos de verificação. |
| Agendar retirada |
Agenda uma remessa para retirada |
| Cancelar remessa |
Cancela uma remessa com uma determinada ID de remessa ou número de acompanhamento |
| Criar uma remessa |
Registra uma remessa com uma transportadora e retorna uma etiqueta de remessa. |
| Etiqueta de Envio de Impressão |
Envia um comando para imprimir a etiqueta de envio com base na cadeia de caracteres base64 |
| Obter impressoras |
A solicitação retorna credenciais, a lista de impressoras disponíveis, suas bandejas e alguns dados adicionais. |
| Obter taxas disponíveis |
Obtém as taxas de envio disponíveis com base nas contas de envio fornecidas. |
Acompanhar a remessa
Rastreia uma remessa com uma transportadora e retorna os pontos de verificação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
operadora
|
carrier | string |
operadora |
|
|
shipping_account
|
shipping_account | float |
shipping_account |
|
|
testar
|
test | boolean |
testar |
|
|
tracking_number
|
tracking_number | string |
tracking_number |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
operadora
|
carrier | string |
operadora |
|
Checkpoints
|
checkpoints | array of object |
Checkpoints |
|
descrição
|
checkpoints.description | string |
descrição |
|
city
|
checkpoints.location.city | string |
city |
|
country
|
checkpoints.location.country | string |
country |
|
postal_code
|
checkpoints.location.postal_code | string |
postal_code |
|
estado
|
checkpoints.location.state | string |
estado |
|
time
|
checkpoints.time | string |
time |
|
status
|
status | string |
status |
Agendar retirada
Agenda uma remessa para retirada
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
operadora
|
carrier | string |
operadora |
|
|
depurar
|
debug | boolean |
depurar |
|
|
descrição
|
description | string |
descrição |
|
|
dim_units
|
dim_units | string |
dim_units |
|
|
cidade de pickup
|
city | string |
city |
|
|
empresa de pickup
|
company | string |
empresa |
|
|
país de retirada
|
country | string |
country |
|
|
email de retirada
|
string |
|
||
|
location_type
|
location_type | string |
location_type |
|
|
nome do pickup
|
name | string |
nome |
|
|
telefone de retirada
|
phone | string |
phone |
|
|
código postal de retirada
|
postal_code | string |
postal_code |
|
|
residencial
|
residential | boolean |
residencial |
|
|
estado de retirada
|
state | string |
estado |
|
|
pickup street1
|
street1 | string |
street1 |
|
|
package_type
|
package_type | string |
package_type |
|
|
height
|
height | integer |
height |
|
|
length
|
length | integer |
length |
|
|
value
|
value | integer |
value |
|
|
peso
|
weight | integer |
peso |
|
|
largura
|
width | integer |
largura |
|
|
cidade do destinatário
|
city | string |
city |
|
|
empresa destinatário
|
company | string |
empresa |
|
|
país destinatário
|
country | string |
country |
|
|
email do destinatário
|
string |
|
||
|
nome do destinatário
|
name | string |
nome |
|
|
telefone destinatário
|
phone | string |
phone |
|
|
código postal do destinatário
|
postal_code | string |
postal_code |
|
|
estado do destinatário
|
state | string |
estado |
|
|
destinatário street1
|
street1 | string |
street1 |
|
|
serviço de remessa
|
service | string |
serviço |
|
|
shipping_account
|
shipping_account | float |
shipping_account |
|
|
testar
|
test | boolean |
testar |
|
|
close_time
|
close_time | string |
close_time |
|
|
date
|
date | string |
date |
|
|
ready_time
|
ready_time | string |
ready_time |
|
|
weight_units
|
weight_units | string |
weight_units |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
operadora
|
shipment.carrier | string |
operadora |
|
Checkpoints
|
shipment.checkpoints | array of object |
Checkpoints |
|
descrição
|
shipment.checkpoints.description | string |
descrição |
|
city
|
shipment.checkpoints.location.city | string |
city |
|
country
|
shipment.checkpoints.location.country | string |
country |
|
estado
|
shipment.checkpoints.location.state | string |
estado |
|
signed_by
|
shipment.checkpoints.signed_by | string |
signed_by |
|
time
|
shipment.checkpoints.time | string |
time |
|
moeda
|
shipment.costs.currency | string |
moeda |
|
net_charge
|
shipment.costs.net_charge | string |
net_charge |
|
moeda
|
shipment.currency | string |
moeda |
|
depurar
|
shipment.debug | boolean |
depurar |
|
entregue
|
shipment.delivered | boolean |
entregue |
|
dim_units
|
shipment.dim_units | string |
dim_units |
|
id
|
shipment.id | string |
id |
|
include_base64_label
|
shipment.include_base64_label | boolean |
include_base64_label |
|
label_type
|
shipment.label_type | string |
label_type |
|
packages
|
shipment.packages | array of object |
packages |
|
height
|
shipment.packages.height | string |
height |
|
etiqueta
|
shipment.packages.label | string |
etiqueta |
|
label_type
|
shipment.packages.label_type | string |
label_type |
|
length
|
shipment.packages.length | string |
length |
|
tracking_number
|
shipment.packages.tracking_number | string |
tracking_number |
|
value
|
shipment.packages.value | string |
value |
|
peso
|
shipment.packages.weight | string |
peso |
|
largura
|
shipment.packages.width | string |
largura |
|
empacotamento
|
shipment.packaging | string |
empacotamento |
|
city
|
shipment.recipient.city | string |
city |
|
empresa
|
shipment.recipient.company | string |
empresa |
|
country
|
shipment.recipient.country | string |
country |
|
email
|
shipment.recipient.email | string |
|
|
nome
|
shipment.recipient.name | string |
nome |
|
phone
|
shipment.recipient.phone | string |
phone |
|
postal_code
|
shipment.recipient.postal_code | string |
postal_code |
|
estado
|
shipment.recipient.state | string |
estado |
|
street1
|
shipment.recipient.street1 | string |
street1 |
|
Referências
|
shipment.references | array of |
Referências |
|
city
|
shipment.sender.city | string |
city |
|
empresa
|
shipment.sender.company | string |
empresa |
|
country
|
shipment.sender.country | string |
country |
|
email
|
shipment.sender.email | string |
|
|
nome
|
shipment.sender.name | string |
nome |
|
phone
|
shipment.sender.phone | string |
phone |
|
postal_code
|
shipment.sender.postal_code | string |
postal_code |
|
estado
|
shipment.sender.state | string |
estado |
|
street1
|
shipment.sender.street1 | string |
street1 |
|
serviço
|
shipment.service | string |
serviço |
|
ship_date
|
shipment.ship_date | string |
ship_date |
|
|
shipment.shipping_account | float |
shipping_account |
|
special_services
|
shipment.special_services | array of |
special_services |
|
status
|
shipment.status | string |
status |
|
testar
|
shipment.test | boolean |
testar |
|
tracking_number
|
shipment.tracking_number | string |
tracking_number |
|
tipo
|
shipment.type | string |
tipo |
|
weight_units
|
shipment.weight_units | string |
weight_units |
Cancelar remessa
Cancela uma remessa com uma determinada ID de remessa ou número de acompanhamento
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
operadora
|
carrier | string |
operadora |
|
|
shipping_account
|
shipping_account | integer |
shipping_account |
|
|
testar
|
test | boolean |
testar |
|
|
tracking_number
|
tracking_number | string |
tracking_number |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
mensagem
|
success.message | string |
mensagem |
Criar uma remessa
Registra uma remessa com uma transportadora e retorna uma etiqueta de remessa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
operadora
|
carrier | string |
operadora |
|
|
moeda
|
currency | string |
moeda |
|
|
depurar
|
debug | boolean |
depurar |
|
|
dim_units
|
dim_units | string |
dim_units |
|
|
include_base64_label
|
include_base64_label | boolean |
include_base64_label |
|
|
label_type
|
label_type | string |
label_type |
|
|
carrier_specific
|
carrier_specific | array of |
carrier_specific |
|
|
height
|
height | integer |
height |
|
|
length
|
length | integer |
length |
|
|
value
|
value | integer |
value |
|
|
peso
|
weight | string |
peso |
|
|
largura
|
width | integer |
largura |
|
|
empacotamento
|
packaging | string |
empacotamento |
|
|
cidade do destinatário
|
city | string |
city |
|
|
empresa destinatário
|
company | string |
empresa |
|
|
país destinatário
|
country | string |
country |
|
|
email do destinatário
|
string |
|
||
|
nome do destinatário
|
name | string |
nome |
|
|
telefone destinatário
|
phone | string |
phone |
|
|
postal_code do destinatário
|
postal_code | string |
postal_code |
|
|
estado do destinatário
|
state | string |
estado |
|
|
destinatário street1
|
street1 | string |
street1 |
|
|
destinatário street2
|
street2 | string |
street2 |
|
|
tipo de referência
|
type | string |
tipo |
|
|
valor de referência
|
value | string |
value |
|
|
cidade do remetente
|
city | string |
city |
|
|
empresa de remetente
|
company | string |
empresa |
|
|
país do remetente
|
country | string |
country |
|
|
email do remetente
|
string |
|
||
|
nome do remetente
|
name | string |
nome |
|
|
telefone remetente
|
phone | string |
phone |
|
|
postal_code do remetente
|
postal_code | string |
postal_code |
|
|
estado do remetente
|
state | string |
estado |
|
|
sender street1
|
street1 | string |
street1 |
|
|
sender street2
|
street2 | string |
street2 |
|
|
serviço
|
service | string |
serviço |
|
|
ship_date
|
ship_date | string |
ship_date |
|
|
shipping_account
|
shipping_account | float |
shipping_account |
|
|
testar
|
test | boolean |
testar |
|
|
tipo
|
type | string |
tipo |
|
|
weight_units
|
weight_units | string |
weight_units |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
operadora
|
shipment.carrier | string |
operadora |
|
base_charge
|
shipment.costs.base_charge | string |
base_charge |
|
moeda
|
shipment.costs.currency | string |
moeda |
|
discounts
|
shipment.costs.discounts | string |
discounts |
|
net_charge
|
shipment.costs.net_charge | string |
net_charge |
|
Sobretaxas
|
shipment.costs.surcharges | string |
Sobretaxas |
|
impostos
|
shipment.costs.taxes | string |
impostos |
|
moeda
|
shipment.currency | string |
moeda |
|
dim_units
|
shipment.dim_units | string |
dim_units |
|
id
|
shipment.id | string |
id |
|
label_type
|
shipment.label_type | string |
label_type |
|
packages
|
shipment.packages | array of object |
packages |
|
height
|
shipment.packages.height | integer |
height |
|
etiqueta
|
shipment.packages.label | string |
etiqueta |
|
label_type
|
shipment.packages.label_type | string |
label_type |
|
length
|
shipment.packages.length | integer |
length |
|
tracking_number
|
shipment.packages.tracking_number | string |
tracking_number |
|
value
|
shipment.packages.value | integer |
value |
|
peso
|
shipment.packages.weight | string |
peso |
|
largura
|
shipment.packages.width | integer |
largura |
|
empacotamento
|
shipment.packaging | string |
empacotamento |
|
city
|
shipment.recipient.city | string |
city |
|
country
|
shipment.recipient.country | string |
country |
|
nome
|
shipment.recipient.name | string |
nome |
|
phone
|
shipment.recipient.phone | string |
phone |
|
postal_code
|
shipment.recipient.postal_code | string |
postal_code |
|
estado
|
shipment.recipient.state | string |
estado |
|
street1
|
shipment.recipient.street1 | string |
street1 |
|
Referências
|
shipment.references | array of object |
Referências |
|
tipo
|
shipment.references.type | string |
tipo |
|
value
|
shipment.references.value | string |
value |
|
city
|
shipment.sender.city | string |
city |
|
country
|
shipment.sender.country | string |
country |
|
nome
|
shipment.sender.name | string |
nome |
|
phone
|
shipment.sender.phone | string |
phone |
|
postal_code
|
shipment.sender.postal_code | string |
postal_code |
|
estado
|
shipment.sender.state | string |
estado |
|
street1
|
shipment.sender.street1 | string |
street1 |
|
serviço
|
shipment.service | string |
serviço |
|
ship_date
|
shipment.ship_date | string |
ship_date |
|
|
shipment.shipping_account | string |
shipping_account |
|
shipping_documents
|
shipment.shipping_documents | array of |
shipping_documents |
|
testar
|
shipment.test | boolean |
testar |
|
tracking_number
|
shipment.tracking_number | string |
tracking_number |
|
tipo
|
shipment.type | string |
tipo |
|
weight_units
|
shipment.weight_units | string |
weight_units |
Etiqueta de Envio de Impressão
Envia um comando para imprimir a etiqueta de envio com base na cadeia de caracteres base64
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
conteúdo
|
content | string |
conteúdo |
|
|
printer_id
|
printer_id | integer |
printer_id |
|
|
bandeja
|
tray | string |
bandeja |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
mensagem
|
success.message | string |
mensagem |
Obter impressoras
A solicitação retorna credenciais, a lista de impressoras disponíveis, suas bandejas e alguns dados adicionais.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
email
|
credentials.email | string |
|
|
senha
|
credentials.password | string |
senha |
|
Impressoras
|
printers | array of object |
Impressoras |
|
active_tray
|
printers.active_tray | string |
active_tray |
|
computer_id
|
printers.computer_id | integer |
computer_id |
|
computer_name
|
printers.computer_name | string |
computer_name |
|
id
|
printers.id | integer |
id |
|
printer_name
|
printers.printer_name | string |
printer_name |
|
status
|
printers.status | string |
status |
|
bandeja
|
printers.tray | array of string |
bandeja |
Obter taxas disponíveis
Obtém as taxas de envio disponíveis com base nas contas de envio fornecidas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
operadora
|
carrier | string |
operadora |
|
|
moeda
|
currency | string |
moeda |
|
|
dim_units
|
dim_units | string |
dim_units |
|
|
height
|
height | integer |
height |
|
|
length
|
length | integer |
length |
|
|
value
|
value | integer |
value |
|
|
peso
|
weight | integer |
peso |
|
|
largura
|
width | integer |
largura |
|
|
cidade do destinatário
|
city | string |
city |
|
|
país destinatário
|
country | string |
country |
|
|
código postal do destinatário
|
postal_code | string |
postal_code |
|
|
estado do destinatário
|
state | string |
estado |
|
|
rua do destinatário 1
|
street1 | string |
street1 |
|
|
cidade do remetente
|
city | string |
city |
|
|
país do remetente
|
country | string |
country |
|
|
cep do remetente
|
postal_code | string |
postal_code |
|
|
estado do remetente
|
state | string |
estado |
|
|
rua remetente 1
|
street1 | string |
street1 |
|
|
shipping_account
|
shipping_account | float |
shipping_account |
|
|
testar
|
test | boolean |
testar |
|
|
tipo
|
type | string |
tipo |
|
|
weight_units
|
weight_units | string |
weight_units |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Taxas
|
rates | array of object |
Taxas |
|
operadora
|
rates.carrier | string |
operadora |
|
moeda
|
rates.currency | string |
moeda |
|
delivery_day
|
rates.delivery_day | string |
delivery_day |
|
service_name
|
rates.service_name | string |
service_name |
|
service_type
|
rates.service_type | string |
service_type |
|
total_cost
|
rates.total_cost | string |
total_cost |