BigCommerce (Pré-visualização)
O BigCommerce é uma plataforma SaaS flexível e aberta. Conecte-se ao BigCommerce para recuperar pedidos, produtos e informações relacionadas.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Dinâmica da Microsoft |
| URL | https://aka.ms/iomsupport |
| iomdri@microsoft.com |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://www.bigcommerce.com/ |
| Política de privacidade | https://www.bigcommerce.com/privacy/ |
| Categorias | Produtividade |
Esse conector foi desenvolvido especificamente para ser usado na integração do provedor Big Commerce do Dynamics 365 Intelligent Order Management.
Pré-requisitos
É necessária uma conta de desenvolvedor do BigCommerce e uma loja de teste. Se você não tiver um, você pode criá-lo em https://developer.bigcommerce.com/ Nota: Recomenda-se usar esse conector especificamente para configurar o provedor Dynamics 365 Intelligent Order Management BigCommerce.
Como obter credenciais
O BigCommerce requer um token de API para autenticação. Você pode gerar um token https://store-XYZ.mybigcommerce.com/manage/settings/auth/api-accounts de API e usá-lo para configurar o conector. Nota: O XYZ é o código hash da sua loja.
Introdução ao conector
Configure a conexão com o token da API. Para saber mais sobre as APIs do BigCommerce, leia a documentação pública: https://developer.bigcommerce.com/api-docs
Problemas conhecidos e limitações
Detalhes sobre os limites de taxa de API podem ser encontrados no seguinte tópico de documentação: https://developer.bigcommerce.com/api-docs/getting-started/best-practices#api-rate-limits Detalhes sobre os limites da plataforma podem ser encontrados no seguinte tópico de documentação: https://developer.bigcommerce.com/api-docs/getting-started/best-practices#platform-limits
Esse conector foi desenvolvido especificamente para ser usado na integração do provedor BigCommerce do Dynamics 365 Intelligent Order Management. O suporte para casos de uso fora do Dynamics 365 Intelligent Order Management será limitado.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 | securestring | A chave de API para esta api | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Atualizar produto |
Atualiza um produto. Read-Only Campos
|
| Atualizar uma encomenda |
Atualiza um pedido. Para saber mais sobre como criar ou atualizar pedidos, consulte Visão geral de pedidos. |
| Listar Produtos de Encomenda |
Lista todos os produtos do pedido em um pedido usando o ID do pedido. |
| Obter endereços de envio de pedidos |
Obtém todos os endereços de envio em um pedido usando o ID do pedido. |
| Obter produto por ID |
Devolve um único Produto. Parâmetros opcionais podem ser passados. |
| Obter produtos |
Devolve uma lista de Produtos. Parâmetros de filtro opcionais podem ser passados. |
| Obter todas as encomendas |
Obtém todos os pedidos usando a consulta de filtro. |
| Obter todos os clientes |
Retorna uma lista de Clientes. Parâmetros de filtro opcionais podem ser passados. |
| Obter uma encomenda |
Obtém um pedido usando o ID do pedido. |
Atualizar produto
Atualiza um produto.
Read-Only Campos
- id
- date_created
- date_modified
- calculated_price
- base_variant_id
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
ID do Produto
|
product_id | True | integer |
A ID do |
|
|
object | |||
|
Incluir campos
|
include_fields | string |
Campos a incluir numa lista separada por vírgula. O ID e os campos especificados serão retornados. |
Devoluções
- ProductResponse
- ProductResponse
Atualizar uma encomenda
Atualiza um pedido. Para saber mais sobre como criar ou atualizar pedidos, consulte Visão geral de pedidos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
order_id
|
order_id | True | integer |
ID da encomenda |
|
|
object |
Devoluções
Objeto de ordem retornado em respostas.
- order_Resp
- order_Resp
Listar Produtos de Encomenda
Lista todos os produtos do pedido em um pedido usando o ID do pedido.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
ID da encomenda
|
order_id | True | string |
ID da encomenda. |
|
Página
|
page | number |
A página a ser retornada na resposta. |
|
|
Limite
|
limit | number |
Número de resultados a devolver. |
Devoluções
Encomende produtos devolvidos em respostas.
Obter endereços de envio de pedidos
Obtém todos os endereços de envio em um pedido usando o ID do pedido.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
ID da encomenda
|
order_id | True | string |
ID da encomenda. |
|
Página
|
page | number |
A página a ser retornada na resposta. |
|
|
Limite
|
limit | number |
Número de resultados a devolver. |
Devoluções
Endereços de envio de pedidos devolvidos em resposta.
Obter produto por ID
Devolve um único Produto. Parâmetros opcionais podem ser passados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
ID do Produto
|
product_id | True | integer |
A ID do |
|
include
|
include | string |
Sub-recursos a incluir em um produto, em uma lista separada por vírgula. Se |
|
|
include_fields
|
include_fields | string |
Campos a incluir numa lista separada por vírgula. O ID e os campos especificados serão retornados. |
|
|
exclude_fields
|
exclude_fields | string |
Campos a excluir, numa lista separada por vírgula. Os campos especificados serão excluídos de uma resposta. O ID não pode ser excluído. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
product_Full
|
data | product_Full | |
|
Meta
|
meta | object |
Meta objeto vazio; pode ser utilizado mais tarde. |
Obter produtos
Devolve uma lista de Produtos. Parâmetros de filtro opcionais podem ser passados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
Id
|
id | integer |
Filtrar itens por id. |
|
|
nome
|
name | string |
Filtre itens por nome. |
|
|
UPC
|
upc | string |
Filtrar itens por upc. |
|
|
Preço
|
price | double |
Filtre os itens por preço. |
|
|
weight
|
weight | double |
Filtrar itens por peso. |
|
|
condition
|
condition | string |
Filtrar itens por condição. |
|
|
brand_id
|
brand_id | integer |
Filtrar itens por brand_id. |
|
|
date_modified
|
date_modified | date-time |
Filtrar itens por |
|
|
date_modified:max
|
date_modified:max | string |
Filtrar itens por |
|
|
date_modified:min
|
date_modified:min | string |
Filtrar itens por |
|
|
date_last_imported
|
date_last_imported | date-time |
Filtrar itens por date_last_imported. |
|
|
date_last_imported:max
|
date_last_imported:max | string |
Filtrar itens por date_last_imported. Por exemplo, |
|
|
date_last_imported:min
|
date_last_imported:min | string |
Filtrar itens por date_last_imported. Por exemplo, |
|
|
is_visible
|
is_visible | boolean |
Filtre os itens com base no facto de o produto estar atualmente visível na montra. |
|
|
is_featured
|
is_featured | string |
Filtrar itens por is_featured.
|
|
|
is_free_shipping
|
is_free_shipping | integer |
Filtrar itens por is_free_shipping. |
|
|
inventory_level
|
inventory_level | integer |
Filtrar itens por inventory_level. |
|
|
inventory_level:em
|
inventory_level:in | integer |
Nível de Inventário |
|
|
inventory_level:not_in
|
inventory_level:not_in | integer |
Nível de Inventário NÃO DENTRO |
|
|
inventory_level:min
|
inventory_level:min | integer |
MIN de Nível de Inventário |
|
|
inventory_level:max
|
inventory_level:max | integer |
Nível de Inventário MAX |
|
|
inventory_level:maior
|
inventory_level:greater | integer |
Nível de Inventário MAIOR |
|
|
inventory_level:menos
|
inventory_level:less | integer |
Nível de Inventário MENOS |
|
|
inventory_low
|
inventory_low | integer |
Filtre os itens por inventory_low. Valores: 1, 0. |
|
|
out_of_stock
|
out_of_stock | integer |
Filtrar itens por out_of_stock. Para ativar o filtro, passe |
|
|
total_sold
|
total_sold | integer |
Filtrar itens por total_sold. |
|
|
tipo
|
type | string |
Filtrar itens por tipo. |
|
|
categories
|
categories | integer |
Filtre itens por categorias.
Se um produto estiver em mais de uma categoria, usar essa consulta não retornará o produto. Em vez disso, use |
|
|
palavra-chave
|
keyword | string |
Filtre itens por palavras-chave encontradas nos |
|
|
keyword_context
|
keyword_context | string |
Defina o contexto usado pelo algoritmo de pesquisa para retornar resultados direcionados para o grupo especificado. Use |
|
|
estado
|
status | integer |
Filtrar itens por status. |
|
|
include
|
include | string |
Sub-recursos a incluir em um produto, em uma lista separada por vírgula. Se |
|
|
include_fields
|
include_fields | string |
Campos a incluir numa lista separada por vírgula. O ID e os campos especificados serão retornados. |
|
|
exclude_fields
|
exclude_fields | string |
Campos a excluir, numa lista separada por vírgula. Os campos especificados serão excluídos de uma resposta. O ID não pode ser excluído. |
|
|
disponibilidade
|
availability | string |
Filtre itens por disponibilidade. Os valores são: disponível, desativado, pré-encomenda. |
|
|
página
|
page | integer |
Especifica o número da página em uma lista limitada (paginada) de produtos. |
|
|
limit
|
limit | integer |
Controla o número de itens por página em uma lista limitada (paginada) de produtos. |
|
|
direção
|
direction | string |
Direção de classificação. Os valores aceitáveis são: |
|
|
ordenar
|
sort | string |
Nome do campo pelo qual classificar. Nota: Desde |
|
|
categorias:em
|
categories:in | integer |
Filtre itens por categorias. Use para produtos em várias categorias. Por exemplo, |
Devoluções
- ProductCollectionResponse
- ProductCollectionResponse
Obter todas as encomendas
Obtém todos os pedidos usando a consulta de filtro.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
ID mínima
|
min_id | integer |
O ID de pedido mínimo. |
|
|
ID máximo da encomenda
|
max_id | integer |
O ID de ordem máximo. |
|
|
Total mínimo
|
min_total | number |
O total mínimo de pedidos em formato float. |
|
|
Total máximo
|
max_total | number |
O total máximo da ordem em formato float. |
|
|
ID do Cliente
|
customer_id | integer |
ID de cliente da encomenda. |
|
|
Email
|
string |
O e-mail do cliente. |
||
|
Status ID
|
status_id | integer |
O staus ID da ordem. |
|
|
ID do carrinho
|
cart_id | string |
O ID do carrinho do pedido. |
|
|
Método de Pagamento
|
payment_method | string |
O método de pagamento utilizado na encomenda. |
|
|
Data mínima criada
|
min_date_created | string |
Data mínima em que o pedido foi criado em RFC-2822 ou ISO-8601. RFC-2822: 'Qui, 20 abr 2017 11:32:00 -0400' ISO-8601: «2017-04-20T11:32:00.000-04:00». |
|
|
Data máxima de criação
|
max_date_created | string |
Data máxima em que o pedido foi criado em RFC-2822 ou ISO-8601. RFC-2822: 'Qui, 20 abr 2017 11:32:00 -0400' ISO-8601: «2017-04-20T11:32:00.000-04:00». |
|
|
Data mínima de modificação
|
min_date_modified | string |
Data mínima em que o pedido foi modificado em RFC-2822 ou ISO-8601. RFC-2822: 'Qui, 20 abr 2017 11:32:00 -0400' ISO-8601: «2017-04-20T11:32:00.000-04:00». |
|
|
Data máxima de modificação
|
max_date_modified | string |
Data máxima em que o pedido foi modificado em RFC-2822 ou ISO-8601. RFC-2822: 'Qui, 20 abr 2017 11:32:00 -0400' ISO-8601: «2017-04-20T11:32:00.000-04:00». |
|
|
Página
|
page | number |
A página a ser retornada na resposta. |
|
|
Limite
|
limit | number |
Número de resultados a devolver. |
|
|
Ordenar
|
sort | string |
Campo e direção para ordenar ordens. Para especificar a direção, adicione ':asc' ou ':d esc' ao final do parâmetro de consulta. Por exemplo, 'sort=date_created:desc'. |
|
|
É suprimido
|
is_deleted | boolean |
Se a encomenda foi eliminada ou arquivada. |
|
|
ID do canal
|
channel_id | boolean |
O ID do canal do pedido. |
Devoluções
Lista de pedidos retornados em respostas.
- Itens
- orderCollection_Resp
Obter todos os clientes
Retorna uma lista de Clientes. Parâmetros de filtro opcionais podem ser passados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
Itens por página.
|
limit | number |
Os itens contam por página.
|
|
|
Filtrar itens por ID.
|
id:in | array |
Filtrar itens por ID.
|
|
|
Filtrar itens por customer_group_id.
|
customer_group_id:in | array |
Filtrar itens por customer_group_id.
|
|
|
Filtrar itens por date_modified.
|
date_modified | date-time |
Filtrar itens por date_modified.
|
|
|
Filtrar itens por date_modified mínimo.
|
date_modified:min | string |
Filtre itens por date_modified mínimo.
|
|
|
Filtrar itens por date_modified máximo.
|
date_modified:max | date-time |
Filtrar itens por date_modified |
|
|
Indica se os subrecursos do cliente devem ser incluídos.
|
include | string |
Indica se os subrecursos do cliente devem ser incluídos:
|
|
|
Ordenar itens.
|
sort | string |
Ordenar os itens por date_created, date_modified ou last_name:* |
Devoluções
- Resposta da Recolha de Clientes
- CustomerCollectionResponse
Obter uma encomenda
Obtém um pedido usando o ID do pedido.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Hash da loja
|
store_hash | True | string |
O código hash da loja. |
|
ID da encomenda
|
order_id | True | string |
ID da encomenda. |
Devoluções
Objeto de ordem retornado em respostas.
- order_Resp
- order_Resp
Definições
address_Full
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
first_name
|
first_name | string |
O primeiro nome do endereço do cliente. |
|
last_name
|
last_name | string |
O sobrenome do endereço do cliente. |
|
Companhia
|
company | string |
A empresa do endereço do cliente. |
|
Endereço1
|
address1 | string |
O endereço 1 linha. |
|
Endereço2
|
address2 | string |
O endereço 2 linha. |
|
city
|
city | string |
A cidade do endereço do cliente. |
|
state_or_province
|
state_or_province | string |
O nome do estado ou província |
|
código postal
|
postal_code | string |
O código postal do endereço do cliente. |
|
country_code
|
country_code | string |
O código do país do endereço do cliente. |
|
phone
|
phone | string |
O número de telefone do endereço do cliente. |
|
Tipo de endereço
|
address_type | string |
O tipo de endereço. Residencial ou Comercial |
|
customer_id
|
customer_id | integer |
O ID do cliente. |
|
id
|
id | integer |
O ID numérico exclusivo do endereço. |
|
country
|
country | string |
O nome do país do endereço do cliente. |
Ajustador
O tipo de ajustador para o preço ou o peso da variante, quando o valor do modificador é selecionado na vitrine.
O tipo de ajustador para o preço ou o peso da variante, quando o valor do modificador é selecionado na vitrine.
- Ajustador
- string
adjuster_Full
Ajustador para Regras Complexas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Ajustador
|
adjuster | Adjuster |
O tipo de ajustador para o preço ou o peso da variante, quando o valor do modificador é selecionado na vitrine. |
|
adjuster_value
|
adjuster_value | double |
A quantidade numérica pela qual o ajustador alterará o preço ou o peso da variante, quando o valor do modificador for selecionado na vitrine. |
adjusters_Full
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
adjuster_Full
|
price | adjuster_Full |
Ajustador para Regras Complexas. |
|
adjuster_Full
|
weight | adjuster_Full |
Ajustador para Regras Complexas. |
|
image_url
|
image_url | string |
A URL de uma imagem exibida na vitrine quando o valor do modificador é selecionado. Limite de 8MB por ficheiro. |
|
ComprandoDesabilitado
|
purchasing_disabled | PurchasingDisabled |
attribute_Full
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
attribute_id
|
attribute_id | integer |
ID do atributo |
|
attribute_value
|
attribute_value | string |
Valor do atributo |
|
customer_id
|
customer_id | integer |
ID do Cliente |
|
date_created
|
date_created | date-time |
A data em que o atributo do cliente foi criado |
|
date_modified
|
date_modified | date-time |
A data em que o atributo do cliente foi modificado |
|
id
|
id | integer |
ID do valor do atributo |
billingAddress_Base
Propriedades do Endereço de Faturação comuns a todos os pedidos e respostas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
first_name
|
first_name | string | |
|
last_name
|
last_name | string | |
|
Companhia
|
company | string | |
|
street_1
|
street_1 | string |
Endereço (primeira linha). |
|
street_2
|
street_2 | string |
Endereço (segunda linha). |
|
city
|
city | string | |
|
state
|
state | string | |
|
ZIP
|
zip | string |
O endereço de faturação deve incluir o código postal. O CEP deve ter dois ou mais caracteres. |
|
country
|
country | string | |
|
country_iso2
|
country_iso2 | string |
Código ISO Alpha-2 de 2 letras para o país. |
|
phone
|
phone | string |
Número de telefone do destinatário. |
|
e-mail
|
string |
Endereço de e-mail do destinatário. |
billingAddress_Full
Necessário para criar um pedido.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
billingAddress_Base
|
billingAddress | billingAddress_Base |
Propriedades do Endereço de Faturação comuns a todos os pedidos e respostas. |
|
form_fields
|
form_fields | array of formFields |
bulkPricingRule_Full
Propriedades comuns da regra de preços em massa
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer |
ID exclusivo da regra de preços em massa. Somente leitura. |
|
quantity_min
|
quantity_min | integer |
A quantidade mínima global de um produto para satisfazer esta regra. Deve ser maior ou igual a zero. Obrigatório em /POST. |
|
quantity_max
|
quantity_max | integer |
A quantidade máxima global de um produto para satisfazer esta regra. Deve ser maior que o |
|
tipo
|
type | string |
O tipo de ajuste que é feito. Valores: |
|
Montante
|
amount | integer |
O desconto pode ser um valor fixo em dólar ou uma porcentagem. Para um valor fixo em dólares, insira-o como um inteiro e a resposta retornará como um inteiro. Para porcentagem, insira o valor como a porcentagem dividida por 100 usando o formato de cadeia de caracteres. Por exemplo, 10% por cento seria ".10". A resposta retornará como um inteiro. Obrigatório em /POST. |
config_Full
Os valores para configuração de opção podem variar com base no modificador criado.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
default_value
|
default_value | string |
(data, texto, multi_line_text numbers_only_text) O valor padrão. Mostrado em uma opção de data como uma cadeia de caracteres formatada em ISO-8601 ou em uma opção de texto como uma cadeia de caracteres. |
|
checked_by_default
|
checked_by_default | boolean |
(caixa de verificação) Sinalizador para definir a caixa de seleção a ser marcada por padrão. |
|
checkbox_label
|
checkbox_label | string |
(caixa de verificação) Rótulo exibido para a opção de caixa de seleção. |
|
date_limited
|
date_limited | boolean |
(data) Sinalizador para limitar as datas permitidas para serem inseridas em uma opção de data. |
|
date_limit_mode
|
date_limit_mode | string |
(data) O tipo de limite que pode ser inserido em uma opção de data. |
|
date_earliest_value
|
date_earliest_value | date |
(data) A data mais antiga permitida pode ser inserida na opção de data, como uma cadeia de caracteres formatada ISO-8601. |
|
date_latest_value
|
date_latest_value | date |
(data) A última data permitida pode ser inserida na opção de data, como uma cadeia de caracteres formatada ISO-8601. |
|
file_types_mode
|
file_types_mode | string |
(ficheiro) O tipo de restrição sobre os tipos de arquivo que podem ser carregados com uma opção de upload de arquivo. Valores: |
|
file_types_supported
|
file_types_supported | array of string |
(ficheiro) O tipo de arquivos que podem ser carregados se o |
|
file_types_other
|
file_types_other | array of string |
(ficheiro) Uma lista de outros tipos de arquivo permitidos com a opção de upload de arquivo. |
|
file_max_size
|
file_max_size | integer |
(ficheiro) O tamanho máximo de um arquivo que pode ser usado com a opção de upload de arquivo. Isso ainda será limitado pelo servidor. |
|
text_characters_limited
|
text_characters_limited | boolean |
(texto, multi_line_text) Sinalizador para validar o comprimento de um texto ou entrada de texto com várias linhas. |
|
text_min_length
|
text_min_length | integer |
(texto, multi_line_text) O comprimento mínimo permitido para uma opção de texto ou texto com várias linhas. |
|
text_max_length
|
text_max_length | integer |
(texto, multi_line_text) O comprimento máximo permitido para uma opção de texto ou texto de várias linhas. |
|
text_lines_limited
|
text_lines_limited | boolean |
(multi_line_text) Sinalizador para validar o número máximo de linhas permitido em uma entrada de texto com várias linhas. |
|
text_max_lines
|
text_max_lines | integer |
(multi_line_text) O número máximo de linhas permitido em uma entrada de texto com várias linhas. |
|
number_limited
|
number_limited | boolean |
(numbers_only_text) Sinalizador para limitar o valor de uma opção de número. |
|
number_limit_mode
|
number_limit_mode | string |
(numbers_only_text) O tipo de limite de valores inseridos para uma opção de número. |
|
number_lowest_value
|
number_lowest_value | double |
(numbers_only_text) O menor valor permitido para uma opção de número se |
|
number_highest_value
|
number_highest_value | double |
(numbers_only_text) O valor mais alto permitido para uma opção de número, se |
|
number_integers_only
|
number_integers_only | boolean |
(numbers_only_text) Sinalizador para limitar a entrada em uma opção de número apenas a números inteiros. |
|
product_list_adjusts_inventory
|
product_list_adjusts_inventory | boolean |
(product_list, product_list_with_images) Sinalizador para ajustar automaticamente o inventário de um produto incluído na lista. |
|
product_list_adjusts_pricing
|
product_list_adjusts_pricing | boolean |
(product_list, product_list_with_images) Sinalizar para adicionar o preço do produto opcional ao preço do produto principal. |
|
product_list_shipping_calc
|
product_list_shipping_calc | string |
(product_list, product_list_with_images) Como considerar o peso do produto opcional e as dimensões da embalagem na cotação de envio. Valores: |
coupons_Resource
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
URL
|
url | string |
URL dos cupons para solicitações de api |
|
recurso
|
resource | string |
recurso dos cupões |
customer_Full
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
e-mail
|
string |
O e-mail do cliente. Deve ser único. |
|
|
first_name
|
first_name | string |
O nome próprio do cliente. |
|
last_name
|
last_name | string |
O apelido do cliente. |
|
Companhia
|
company | string |
A empresa do cliente. |
|
phone
|
phone | string |
O número de telefone do cliente. |
|
registration_ip_address
|
registration_ip_address | string |
O endereço IP a partir do qual este cliente foi registado. |
|
Observações
|
notes | string |
O cliente observa. |
|
tax_exempt_category
|
tax_exempt_category | string |
O código da categoria isenta de impostos para o cliente. |
|
customer_group_id
|
customer_group_id | integer |
ID do grupo ao qual este cliente pertence. |
|
id
|
id | integer |
O ID numérico exclusivo do cliente. |
|
date_modified
|
date_modified | date-time |
A data em que o cliente foi modificado. |
|
date_created
|
date_created | date-time |
A data em que o cliente foi criado. |
|
address_count
|
address_count | integer |
Número total de endereços de clientes. |
|
attribute_count
|
attribute_count | integer |
Número total de atributos do cliente. |
|
force_password_reset
|
authentication.force_password_reset | boolean |
Se |
|
addresses
|
addresses | array of address_Full |
Matriz de endereços de clientes. Limitado a 10. |
|
attributes
|
attributes | array of attribute_Full |
Matriz de atributos do cliente. Limitado a 10. |
|
store_credit_amounts
|
store_credit_amounts | CustomerStoredCreditAmounts |
Crédito da loja. |
|
accepts_product_review_abandoned_cart_emails
|
accepts_product_review_abandoned_cart_emails | boolean |
Ele determina se o cliente está inscrito para receber e-mails de revisão de produto ou carrinho abandonado ou receber ambos os e-mails. |
|
customerChannelIds
|
channel_ids | customerChannelIds |
Matriz de ids de canal aos quais o Cliente tem acesso. |
CustomerCollectionResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of customer_Full |
customerChannelIds
Matriz de ids de canal aos quais o Cliente tem acesso.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
integer |
CustomerStoredCreditAmounts
Crédito da loja.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Montante
|
amount | float |
customUrl_Full
O URL personalizado para o produto na vitrine.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
URL
|
url | string |
URL do produto na montra. |
|
is_customized
|
is_customized | boolean |
Retorna |
formFields
Somente leitura. Se você tiver campos de formulário de endereço obrigatórios, eles precisarão ser definidos como opcionais antes de criar um pedido via API.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
nome
|
name | string |
Somente leitura. Se você tiver campos de formulário de endereço obrigatórios, eles precisarão ser definidos como opcionais antes de criar um pedido via API. |
|
valor
|
value | string |
Somente leitura. Se você tiver campos de formulário de endereço obrigatórios, eles precisarão ser definidos como opcionais antes de criar um pedido via API. |
Links
Links de paginação para as partes anterior e seguinte de toda a coleção.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
anterior
|
previous | string |
Link para a página anterior retornado na resposta. |
|
atual
|
current | string |
Link para a página atual retornada na resposta. |
|
next
|
next | string |
Link para a próxima página retornada na resposta. |
metaCollection_Full
Dados sobre a resposta, incluindo paginação e totais de coleta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
pagination_Full
|
pagination | pagination_Full |
Dados sobre a resposta, incluindo paginação e totais de coleta. |
order_Resp
Objeto de ordem retornado em respostas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer |
Somente leitura. O ID do pedido. |
|
date_modified
|
date_modified | string |
Um valor somente leitura que representa a última modificação da ordem. Não tente modificar ou definir esse valor em uma operação POST ou PUT. RFC-2822 |
|
date_shipped
|
date_shipped | string |
Um valor somente leitura que representa a data de envio. Não tente modificar ou definir esse valor em uma operação POST ou PUT. RFC-2822 |
|
cart_id
|
cart_id | string |
O ID do carrinho do qual esta encomenda teve origem, se aplicável. Correlaciona-se com a API do carrinho. Este é um campo READ-ONLY; não defina ou modifique seu valor em uma solicitação POST ou PUT. |
|
estado
|
status | string |
O status incluirá um dos (string, optiona) - valores definidos em Status do pedido. Esse valor é somente leitura. Não tente modificar ou definir esse valor em uma operação POST ou PUT. |
|
subtotal_tax
|
subtotal_tax | string |
Um valor somente leitura. Não tente definir ou modificar esse valor em uma operação POST ou PUT. (Float, Float-As-String, Inteiro) |
|
shipping_cost_tax
|
shipping_cost_tax | string |
Um valor somente leitura. Não tente modificar ou definir esse valor em uma operação POST ou PUT. (Float, Float-As-String, Inteiro) |
|
shipping_cost_tax_class_id
|
shipping_cost_tax_class_id | integer |
Classe de imposto de custo de envio. Um valor somente leitura. Não tente modificar ou definir esse valor em uma operação POST ou PUT. (NOTA: Valor ignorado se o imposto automático estiver habilitado na loja.) |
|
handling_cost_tax
|
handling_cost_tax | string |
Um valor somente leitura. Não tente modificar ou definir esse valor em uma operação POST ou PUT. (Float, Float-As-String, Inteiro) |
|
handling_cost_tax_class_id
|
handling_cost_tax_class_id | integer |
Um valor somente leitura. Não tente definir ou modificar esse valor em uma operação POST ou PUT. (NOTA: Valor ignorado se o imposto automático estiver habilitado na loja.) |
|
wrapping_cost_tax
|
wrapping_cost_tax | string |
Um valor somente leitura. Não tente modificar ou definir esse valor em uma operação POST ou PUT. (Float, Float-As-String, Inteiro) |
|
wrapping_cost_tax_class_id
|
wrapping_cost_tax_class_id | integer |
Um valor somente leitura. Não tente definir ou modificar esse valor em uma operação POST ou PUT. (NOTA: Valor ignorado se o imposto automático estiver habilitado na loja.) |
|
PagamentoStatus
|
payment_status | PaymentStatus |
Um valor somente leitura. Não tente definir ou modificar esse valor em uma operação POST ou PUT. |
|
store_credit_amount
|
store_credit_amount | string |
Representa o crédito da loja que o comprador resgatou neste pedido individual. Este é um valor somente leitura. Não passe em um POST ou PUT. (Float, Float-As-String, Inteiro) |
|
gift_certificate_amount
|
gift_certificate_amount | string |
Um valor somente leitura. Não passe em um POST ou PUT. (Float, Float-As-String, Inteiro) |
|
currency_id
|
currency_id | integer |
O ID da moeda de exibição. Pode ser diferente da moeda transacional. Um valor somente leitura. Não passe em um POST ou PUT. |
|
currency_code
|
currency_code | string |
O código de moeda da moeda de exibição usada para apresentar os preços na vitrine. Um valor somente leitura. Não passe em um POST ou PUT. |
|
currency_exchange_rate
|
currency_exchange_rate | string |
A taxa de câmbio entre a moeda padrão da loja e a moeda de exibição. Um valor somente leitura. Não passe em um POST ou PUT. (Float, Float-As-String, Inteiro) |
|
default_currency_id
|
default_currency_id | integer |
O ID da moeda transacional. Um valor somente leitura. Não passe em um POST ou PUT. |
|
coupon_discount
|
coupon_discount | string |
Um valor somente leitura. Não passe em um POST ou PUT. (Float, Float-As-String, Inteiro) |
|
shipping_address_count
|
shipping_address_count | double |
O número de endereços de envio associados a esta transação. Um valor somente leitura. Não passe em um POST ou PUT. |
|
is_email_opt_in
|
is_email_opt_in | boolean |
Indica se o comprador selecionou uma caixa de seleção de aceitação (na página de checkout) para receber e-mails. Um valor somente leitura. Não passe em um POST ou PUT. |
|
order_source
|
order_source | string |
As encomendas submetidas através do site da loja incluirão um |
|
products_Resource
|
products | products_Resource | |
|
shippingAddress_Resource
|
shipping_addresses | shippingAddress_Resource | |
|
coupons_Resource
|
coupons | coupons_Resource | |
|
status_id
|
status_id | integer |
O staus ID da ordem. |
|
base_handling_cost
|
base_handling_cost | string |
O valor do custo de manuseamento de base. (Float, Float-As-String, Inteiro) |
|
base_shipping_cost
|
base_shipping_cost | string |
O valor do custo de envio base. (Float, Float-As-String, Inteiro) |
|
base_wrapping_cost
|
base_wrapping_cost | string |
O valor do custo de embrulho de base. (Float, Float-As-String, Inteiro) |
|
billingAddress_Full
|
billing_address | billingAddress_Full |
Necessário para criar um pedido. |
|
channel_id
|
channel_id | integer |
Mostra a origem do pedido. O padrão channel_id será 1. |
|
customer_id
|
customer_id | double | |
|
customer_message
|
customer_message | string |
Mensagem que o cliente inseriu (número, opcional) -o caixa durante o |
|
date_created
|
date_created | string |
A data em que esta ordem foi criada. Se não for especificado, o padrão será a hora atual. A data deve estar no formato RFC 2822. |
|
default_currency_code
|
default_currency_code | string |
O código da moeda transacional que o comprador paga; gravável quando a multimoeda está ativada. |
|
discount_amount
|
discount_amount | string |
Valor do desconto para esta transação. (Float, Float-As-String, Inteiro) |
|
ebay_order_id
|
ebay_order_id | string |
Se a encomenda tiver sido feita através do eBay, o número da encomenda do eBay será incluído. Caso contrário, o valor será |
|
external_id
|
external_id | string |
ID do pedido em outro sistema. Por exemplo, o ID do pedido da Amazon se este for um pedido da Amazon. Este campo pode ser atualizado em um /POST, mas usar um /PUT para atualizar o pedido retornará um erro 400. O campo «external_id» não pode ser escrito. Por favor, remova-o do seu pedido antes de tentar novamente. Ele não pode ser substituído uma vez definido. |
|
external_source
|
external_source | string |
Para pedidos enviados ou modificados através da API, usando uma operação PUT ou POST, você pode, opcionalmente, passar um valor que identifique o sistema usado para gerar o pedido. Por exemplo: |
|
geoip_country
|
geoip_country | string |
O nome completo do país onde o cliente fez a compra, com base no IP. |
|
geoip_country_iso2
|
geoip_country_iso2 | string |
O país onde o cliente fez a compra, em formato ISO2, com base no IP. |
|
handling_cost_ex_tax
|
handling_cost_ex_tax | string |
O valor do custo de manuseamento, excluindo impostos. (Float, Float-As-String, Inteiro) |
|
handling_cost_inc_tax
|
handling_cost_inc_tax | string |
O valor do custo de manuseamento, incluindo impostos. (Float, Float-As-String, Inteiro) |
|
ip_address
|
ip_address | string |
Endereço IP do cliente, se conhecido. |
|
is_deleted
|
is_deleted | boolean |
Indica se o pedido foi excluído (arquivado). Defina como true, para arquivar uma ordem. |
|
items_shipped
|
items_shipped | double |
O número de itens que foram enviados. |
|
items_total
|
items_total | double |
O número total de itens na ordem. |
|
order_is_digital
|
order_is_digital | boolean |
Se este é um pedido de produtos digitais. |
|
Método de Pagamento
|
payment_method | PaymentMethod |
O método de pagamento para esta encomenda. Pode ser um dos seguintes: |
|
payment_provider_id
|
payment_provider_id | string |
O ID de transação/ID de pagamento externo dentro do provedor de pagamento desta ordem (se um provedor de pagamento foi usado). |
|
refunded_amount
|
refunded_amount | string |
O valor reembolsado desta transação. (Float, Float-As-String, Inteiro) |
|
shipping_cost_ex_tax
|
shipping_cost_ex_tax | string |
O valor do custo de envio, excluindo impostos. (Float, Float-As-String, Inteiro) |
|
shipping_cost_inc_tax
|
shipping_cost_inc_tax | string |
O valor do custo de envio, incluindo impostos. (Float, Float-As-String, Inteiro) |
|
staff_notes
|
staff_notes | string |
Quaisquer notas adicionais para o pessoal. |
|
subtotal_ex_tax
|
subtotal_ex_tax | string |
Valor de substituição para o subtotal excluindo impostos. Se especificado, o campo |
|
subtotal_inc_tax
|
subtotal_inc_tax | string |
Valor de substituição para o subtotal, incluindo impostos. Se especificado, o campo |
|
TaxProviderId
|
tax_provider_id | TaxProviderId |
BasicTaxProvider - O imposto é definido como manual. AvaTaxProvider - Isso é para quando o provedor de impostos foi definido como automático e o pedido NÃO foi criado pela API. Usado para Avalara. "" (em branco) - Quando o provedor fiscal é desconhecido. Isso inclui pedidos legados e pedidos criados anteriormente via API. Isso pode ser definido ao criar um pedido usando um POST. |
|
customer_locale
|
customer_locale | string |
A localidade do cliente |
|
total_ex_tax
|
total_ex_tax | string |
Valor de substituição para o total, excluindo impostos. Se especificado, o campo |
|
total_inc_tax
|
total_inc_tax | string |
Valor de substituição para o total, incluindo impostos. Se especificado, o campo |
|
wrapping_cost_ex_tax
|
wrapping_cost_ex_tax | string |
O valor do custo de acondicionamento, excluindo impostos. (Float, Float-As-String, Inteiro) |
|
wrapping_cost_inc_tax
|
wrapping_cost_inc_tax | string |
O valor do custo de embrulho, incluindo impostos. (Float, Float-As-String, Inteiro) |
orderCollection_Resp
Lista de pedidos retornados em respostas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
order_Resp
|
order_Resp |
Objeto de ordem retornado em respostas. |
orderProduct_Resp
Encomende o produto devolvido em respostas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer |
ID numérico deste produto dentro desta ordem. |
|
order_id
|
order_id | integer |
ID numérico da ordem associada. |
|
product_id
|
product_id | integer |
ID numérico do produto. |
|
order_address_id
|
order_address_id | integer |
ID numérico do endereço de ordem associado. |
|
nome
|
name | string |
Alias for name_customer - O nome do produto que é mostrado ao cliente na vitrine. |
|
sku
|
sku | string |
Código do produto/unidade de manutenção de estoque (SKU) definido pelo usuário. |
|
tipo
|
type | string |
Tipo de produto. |
|
base_price
|
base_price | string |
O preço base do produto. (Float, Float-As-String, Inteiro). |
|
price_ex_tax
|
price_ex_tax | string |
O preço do produto sem impostos. (Float, Float-As-String, Inteiro). |
|
price_inc_tax
|
price_inc_tax | string |
O preço do produto, incluindo impostos. (Float, Float-As-String, Inteiro). |
|
price_tax
|
price_tax | string |
Valor do imposto aplicado a um único produto. O imposto sobre o preço é calculado como: 'price_tax = price_inc_tax - price_ex_tax' (Float, Float-As-String, Integer). |
|
base_total
|
base_total | string |
Preço base total. (Float, Float-As-String, Inteiro). |
|
total_ex_tax
|
total_ex_tax | string |
Preço base total sem impostos. (Float, Float-As-String, Inteiro). |
|
total_inc_tax
|
total_inc_tax | string |
Preço base total incluindo impostos. (Float, Float-As-String, Inteiro). |
|
total_tax
|
total_tax | string |
Total do imposto aplicado aos produtos. Por exemplo, se a quantidade for 2, o preço base for 5 e a taxa de imposto for 10%. price_tax será de $.50 e total_tax será de $1.00. Se houver um desconto manual aplicado, total_tax é dimensionado da seguinte forma: '(price_ex_tax - desconto)*tax_rate=total_tax' (Float, Float-As-String, Integer). |
|
quantidade
|
quantity | number |
Quantidade do produto encomendado. |
|
base_cost_price
|
base_cost_price | string |
O preço de custo do produto. Isso pode ser definido usando a API de catálogo. (Float, Float-As-String, Inteiro) Somente leitura. |
|
cost_price_inc_tax
|
cost_price_inc_tax | string |
O preço de custo do produto, incluindo impostos. (Float, Float-As-String, Inteiro) O custo dos seus produtos para si; Isso nunca é mostrado aos clientes, mas pode ser usado para fins contábeis. Somente leitura. |
|
cost_price_ex_tax
|
cost_price_ex_tax | string |
Os produtos custam preço sem impostos. (Float, Float-As-String, Inteiro) O custo dos seus produtos para si; Isso nunca é mostrado aos clientes, mas pode ser usado para fins contábeis. Somente leitura. |
|
weight
|
weight | string |
Peso do produto. (Float, Float-As-String, Inteiro). |
|
cost_price_tax
|
cost_price_tax | string |
Imposto aplicado ao preço de custo do produto. (Float, Float-As-String, Inteiro) O custo dos seus produtos para si; Isso nunca é mostrado aos clientes, mas pode ser usado para fins contábeis. Somente leitura. |
|
is_refunded
|
is_refunded | boolean |
Se o produto foi reembolsado. |
|
refunded_amount
|
refunded_amount | string |
O valor reembolsado desta transação. (Float, Float-As-String, Inteiro). |
|
return_id
|
return_id | number |
ID numérico para o reembolso. |
|
wrapping_name
|
wrapping_name | string |
Nome da opção de embrulho de presente. |
|
base_wrapping_cost
|
base_wrapping_cost | string |
O valor do custo de embrulho de base. (Float, Float-As-String, Inteiro). |
|
wrapping_cost_ex_tax
|
wrapping_cost_ex_tax | string |
O valor do custo de acondicionamento, excluindo impostos. (Float, Float-As-String, Inteiro). |
|
wrapping_cost_inc_tax
|
wrapping_cost_inc_tax | string |
O valor do custo de embrulho, incluindo impostos. (Float, Float-As-String, Inteiro). |
|
wrapping_cost_tax
|
wrapping_cost_tax | string |
Imposto aplicado à opção de embrulho de presentes. (Float, Float-As-String, Inteiro). |
|
wrapping_message
|
wrapping_message | string |
Mensagem para acompanhar a opção de embrulho de presente. |
|
quantity_shipped
|
quantity_shipped | number |
Quantidade deste item enviado. |
|
event_name
|
event_name | string |
Nome do evento promocional/data de entrega. |
|
event_date
|
event_date | date |
Data do evento promocional/entrega programada. |
|
fixed_shipping_cost
|
fixed_shipping_cost | string |
Custo de envio fixo para este produto. (Float, Float-As-String, Inteiro). |
|
ebay_item_id
|
ebay_item_id | string |
ID do item para este produto no eBay. |
|
ebay_transaction_id
|
ebay_transaction_id | string |
ID de transação para este produto no eBay. |
|
option_set_id
|
option_set_id | integer |
ID numérico do conjunto de opções aplicado ao produto. |
|
parent_order_product_id
|
parent_order_product_id | integer |
ID de um produto pai. |
|
is_bundled_product
|
is_bundled_product | boolean |
Se este produto está incluído em conjunto com outros produtos. |
|
bin_picking_number
|
bin_picking_number | string |
Número de coleta de lixo para o produto físico. |
|
applied_discounts
|
applied_discounts | array of object |
Matriz de objetos contendo descontos aplicados ao produto. |
|
id
|
applied_discounts.id | string |
Nome do cupão aplicado à encomenda. |
|
Montante
|
applied_discounts.amount | string |
Valor do desconto. (Float, Float-As-String, Inteiro). |
|
nome
|
applied_discounts.name | string |
Nome do cupão.
|
|
código
|
applied_discounts.code | string |
Código do cupom. Não há código ao criar um desconto manual. |
|
destino
|
applied_discounts.target | string |
Determina se o desconto se o desconto foi aplicado no nível do pedido ou do produto. Somente leitura. |
|
product_options
|
product_options | array of object |
Matriz de objetos de opção de produto. |
|
id
|
product_options.id | integer |
O ID numérico único da opção; incrementos sequenciais. |
|
option_id
|
product_options.option_id | integer |
ID numérico da opção associada. |
|
order_product_id
|
product_options.order_product_id | integer |
Id do produto para encomenda. |
|
product_option_id
|
product_options.product_option_id | integer |
Id da opção do produto. |
|
display_name
|
product_options.display_name | string |
Alias para display_name_customer. O nome da opção de produto que é mostrado ao cliente na vitrine. |
|
display_value
|
product_options.display_value | string |
Alias para display_value_customer. O valor da opção do produto que é mostrado ao cliente na vitrine. |
|
valor
|
product_options.value | string |
Esse valor é usado para acessar o Carregamento de Arquivo do Cliente. |
|
tipo
|
product_options.type | string |
Tipo de opção. |
|
nome
|
product_options.name | string |
O nome da opção, conforme usado internamente. Deve ser único. |
|
display_style
|
product_options.display_style | string |
Como é exibido na vitrine. Os exemplos incluem lista suspensa, botões de opção ou retângulos. |
|
display_name_customer
|
product_options.display_name_customer | string |
O nome da opção do produto que é mostrado ao cliente na vitrine. |
|
display_name_merchant
|
product_options.display_name_merchant | string |
O nome da opção do produto que é mostrado ao comerciante no Painel de Controlo. |
|
display_value_customer
|
product_options.display_value_customer | string |
O valor da opção do produto que é mostrado ao cliente na vitrine. |
|
display_value_merchant
|
product_options.display_value_merchant | string |
O valor da opção do produto que é mostrado ao comerciante no Painel de Controlo. |
|
external_id
|
external_id | string |
ID do pedido em outro sistema. Por exemplo, o ID do pedido da Amazon se este for um pedido da Amazon. Este campo pode ser atualizado em um /POST, mas usar um /PUT para atualizar o pedido retornará um erro 400. O campo «external_id» não pode ser escrito. Por favor, remova-o do seu pedido antes de tentar novamente. Ele não pode ser substituído uma vez definido. |
|
UPC
|
upc | string |
Código Universal do Produto. Pode ser escrito para produtos personalizados e produtos de catálogo. |
|
variant_id
|
variant_id | integer |
Produtos |
|
name_customer
|
name_customer | string |
O nome do produto que é mostrado ao cliente na vitrine. |
|
name_merchant
|
name_merchant | string |
O nome do produto que é mostrado ao comerciante no Painel de Controlo. |
orderProductsCollection_Resp
Encomende produtos devolvidos em respostas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
orderProduct_Resp
|
orderProduct_Resp |
Encomende o produto devolvido em respostas. |
orderShippingAddress_Resp
Endereço de envio da encomenda devolvido em resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer |
ID deste endereço de envio. |
|
order_id
|
order_id | integer |
ID da encomenda. |
|
items_total
|
items_total | number |
O número total de itens na ordem. |
|
items_shipped
|
items_shipped | number |
O número de itens que foram enviados. |
|
base_cost
|
base_cost | string |
O valor base dos itens do pedido. (Float, Float-As-String, Inteiro). |
|
cost_ex_tax
|
cost_ex_tax | string |
O valor dos itens do pedido, excluindo impostos. (Float, Float-As-String, Inteiro). |
|
cost_inc_tax
|
cost_inc_tax | string |
O valor dos itens do pedido, incluindo impostos. (Float, Float-As-String, Inteiro). |
|
cost_tax
|
cost_tax | string |
O valor do imposto sobre a ordem. (Float, Float-As-String, Inteiro). |
|
cost_tax_class_id
|
cost_tax_class_id | integer |
A ID da classe de imposto aplicada ao produto. (NOTA: Valor ignorado se o imposto automático estiver ativado). |
|
handling_cost_ex_tax
|
handling_cost_ex_tax | string |
A taxa de manuseamento, excluindo impostos. (Float, Float-As-String, Inteiro). |
|
handling_cost_inc_tax
|
handling_cost_inc_tax | string |
A taxa de manuseamento, incluindo impostos. (Float, Float-As-String, Inteiro). |
|
handling_cost_tax
|
handling_cost_tax | string | |
|
handling_cost_tax_class_id
|
handling_cost_tax_class_id | integer |
Um valor somente leitura. Não tente definir ou modificar esse valor em uma operação POST ou PUT. (NOTA: Valor ignorado se o imposto automático estiver ativado na loja). |
|
shipping_zone_id
|
shipping_zone_id | number |
ID numérico da zona de envio. |
|
shipping_zone_name
|
shipping_zone_name | string |
Nome da zona de expedição. |
|
form_fields
|
form_fields | array of formFields | |
|
shippingQuotes_Resource
|
shipping_quotes | shippingQuotes_Resource | |
|
shippingAddress_Base
|
shipping_addresses | shippingAddress_Base |
Propriedades do endereço de envio comuns a todas as solicitações e respostas. |
orderShippingAddressCollection_Resp
Endereços de envio de pedidos devolvidos em resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
orderShippingAddress_Resp
|
orderShippingAddress_Resp |
Endereço de envio da encomenda devolvido em resposta. |
pagination_Full
Dados sobre a resposta, incluindo paginação e totais de coleta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
total
|
total | integer |
Número total de itens no conjunto de resultados. |
|
count
|
count | integer |
Número total de itens na resposta da coleção. |
|
per_page
|
per_page | integer |
A quantidade de itens retornados na coleção por página, controlada pelo parâmetro limit. |
|
current_page
|
current_page | integer |
A página em que você está atualmente dentro da coleção. |
|
total_pages
|
total_pages | integer |
O número total de páginas na coleção. |
|
Links
|
links | Links |
Links de paginação para as partes anterior e seguinte de toda a coleção. |
product_Base
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
nome
|
name | string |
O nome do produto. |
|
tipo
|
type | string |
O tipo de produto. Um dos: |
|
sku
|
sku | string |
Código do produto/unidade de manutenção de estoque (SKU) definido pelo usuário. |
|
descrição
|
description | string |
A descrição do produto, que pode incluir formatação HTML. |
|
weight
|
weight | double |
Peso do produto, que pode ser usado no cálculo dos custos de envio. Isto é baseado na unidade definida na loja |
|
Largura
|
width | double |
Largura do produto, que pode ser usada para calcular os custos de envio. |
|
profundidade
|
depth | double |
Profundidade do produto, que pode ser usada no cálculo dos custos de envio. |
|
altura
|
height | double |
Altura do produto, que pode ser usada no cálculo dos custos de envio. |
|
Preço
|
price | double |
O preço do produto. O preço deve incluir ou excluir impostos, com base nas configurações da loja. |
|
cost_price
|
cost_price | double |
O preço de custo do produto. Armazenado apenas para referência; Ele não é usado ou exibido em qualquer lugar da loja. |
|
retail_price
|
retail_price | double |
O custo de varejo do produto. Se inserido, o preço de custo de varejo será mostrado na página do produto. |
|
sale_price
|
sale_price | double |
Se inserido, o preço de venda será usado em vez do valor no campo preço ao calcular o custo do produto. |
|
map_price
|
map_price | double |
Preço Mínimo Anunciado |
|
tax_class_id
|
tax_class_id | integer |
A ID da classe de imposto aplicada ao produto. (NOTA: Valor ignorado se o imposto automático estiver habilitado.) |
|
product_tax_code
|
product_tax_code | string |
Aceita os Códigos Fiscais do Sistema AvaTax, que identificam produtos e serviços que se enquadram em categorias especiais de imposto sobre vendas. Ao usar esses códigos, os comerciantes que assinam a integração Avalara Premium do BigCommerce podem calcular os impostos sobre vendas com mais precisão. As lojas sem Avalara Premium ignorarão o código ao calcular o imposto sobre vendas. Não passe mais do que um código. Os códigos diferenciam maiúsculas de minúsculas. Para mais detalhes, consulte a documentação de Avalara. |
|
categories
|
categories | array of integer |
Uma matriz de IDs para as categorias às quais este produto pertence. Ao atualizar um produto, se uma matriz de categorias for fornecida, todas as categorias de produtos serão substituídas. Não aceita mais de 1.000 valores de ID. |
|
brand_id
|
brand_id | integer |
Um produto pode ser adicionado a uma marca existente durante um produto /PUT ou /POST. |
|
inventory_level
|
inventory_level | integer |
Nível de estoque atual do produto. O rastreamento de inventário simples deve ser ativado (Consulte o |
|
inventory_warning_level
|
inventory_warning_level | integer |
Nível de aviso de inventário para o produto. Quando o nível de estoque do produto cair abaixo do nível de alerta, o proprietário da loja será informado. O rastreamento de inventário simples deve ser ativado (consulte o |
|
inventory_tracking
|
inventory_tracking | string |
O tipo de rastreamento de estoque para o produto. Os valores são: |
|
fixed_cost_shipping_price
|
fixed_cost_shipping_price | double |
Um custo de envio fixo para o produto. Se definido, este valor será usado durante o checkout em vez do cálculo normal do custo de envio. |
|
is_free_shipping
|
is_free_shipping | boolean |
Bandeira usada para indicar se o produto tem frete grátis. Se |
|
is_visible
|
is_visible | boolean |
Sinalizar para determinar se o produto deve ser exibido para os clientes que navegam na loja. Se |
|
is_featured
|
is_featured | boolean |
Sinalizar para determinar se o produto deve ser incluído no |
|
related_products
|
related_products | array of integer |
Uma matriz de IDs para os produtos relacionados. |
|
garantia
|
warranty | string |
Informações de garantia exibidas na página do produto. Pode incluir formatação HTML. |
|
bin_picking_number
|
bin_picking_number | string |
O número de separação BIN para o produto. |
|
layout_file
|
layout_file | string |
O arquivo de modelo de layout usado para renderizar esta categoria de produto. Este campo é gravável apenas para lojas com um tema Blueprint aplicado. |
|
UPC
|
upc | string |
O código UPC do produto, que é usado em feeds para sites de comparação de compras e integrações de canais externos. |
|
search_keywords
|
search_keywords | string |
Uma lista separada por vírgulas de palavras-chave que podem ser usadas para localizar o produto ao pesquisar na loja. |
|
disponibilidade
|
availability | string |
Disponibilidade do produto. As opções de disponibilidade são: |
|
availability_description
|
availability_description | string |
Texto de disponibilidade exibido na página de checkout, sob o título do produto. Informa o cliente quanto tempo normalmente levará para enviar este produto, como: "Normalmente envia em 24 horas." |
|
gift_wrapping_options_type
|
gift_wrapping_options_type | string |
Tipo de opções de embrulho para presentes. Valores: |
|
gift_wrapping_options_list
|
gift_wrapping_options_list | array of integer |
Uma lista de IDs de opção de embrulho de presente. |
|
sort_order
|
sort_order | integer |
Prioridade para dar este produto quando incluído em listas de produtos em páginas de categorias e nos resultados de pesquisa. Números inteiros mais baixos colocarão o produto mais perto do topo dos resultados. |
|
condition
|
condition | string |
A condição do produto. Será mostrado na página do produto se o valor do |
|
is_condition_shown
|
is_condition_shown | boolean |
Sinalizador usado para determinar se a condição do produto é mostrada ao cliente na página do produto. |
|
order_quantity_minimum
|
order_quantity_minimum | integer |
A quantidade mínima que uma encomenda deve conter, para ser elegível para comprar este produto. |
|
order_quantity_maximum
|
order_quantity_maximum | integer |
A quantidade máxima que um pedido pode conter ao comprar o produto. |
|
page_title
|
page_title | string |
Título personalizado para a página do produto. Se não estiver definido, o nome do produto será usado como metatítulo. |
|
meta_keywords
|
meta_keywords | array of string |
Meta-palavras-chave personalizadas para a página do produto. Se não forem definidas, as palavras-chave padrão da loja serão usadas. |
|
meta_description
|
meta_description | string |
Meta descrição personalizada para a página do produto. Se não for definida, a meta descrição padrão da loja será usada. |
|
view_count
|
view_count | integer |
O número de vezes que o produto foi visualizado. |
|
preorder_release_date
|
preorder_release_date | date-time |
Data de lançamento da pré-encomenda. Consulte o |
|
preorder_message
|
preorder_message | string |
Mensagem personalizada de data esperada para exibição na página do produto. Se indefinido, o padrão da mensagem é a configuração storewide. Pode conter o |
|
is_preorder_only
|
is_preorder_only | boolean |
Se definido como true, na data de lançamento da pré-encomenda, o status da pré-encomenda será removido automaticamente.
Se definido como false, na data de lançamento o status da pré-encomenda não será removido. Ele precisará ser alterado manualmente no painel de controle ou usando a API. Usando a API definida |
|
is_price_hidden
|
is_price_hidden | boolean |
False por padrão, indicando que o preço deste produto deve ser mostrado na página do produto. Se definido como |
|
price_hidden_label
|
price_hidden_label | string |
Por padrão, uma cadeia de caracteres vazia. Se |
|
customUrl_Full
|
custom_url | customUrl_Full |
O URL personalizado para o produto na vitrine. |
|
open_graph_type
|
open_graph_type | string |
Tipo de produto, o padrão é |
|
open_graph_title
|
open_graph_title | string |
Título do produto, se não especificado o nome do produto será usado em vez disso. |
|
open_graph_description
|
open_graph_description | string |
Descrição a utilizar para o produto, se não for especificada, a meta_description será utilizada em vez disso. |
|
open_graph_use_meta_description
|
open_graph_use_meta_description | boolean |
Sinalizador para determinar se a descrição do produto ou a descrição do gráfico aberto é usada. |
|
open_graph_use_product_name
|
open_graph_use_product_name | boolean |
Sinalizador para determinar se o nome do produto ou o nome do gráfico aberto é usado. |
|
open_graph_use_image
|
open_graph_use_image | boolean |
Sinalizador para determinar se a imagem do produto ou a imagem do gráfico aberto é usada. |
|
brand_name ou brand_id
|
brand_name or brand_id | string |
A marca pode ser criada durante um pedido de produto PUT ou POST. Se a marca já existir, o produto será adicionado. Caso contrário, a marca será criada e o produto adicionado. Se usar |
|
GTIN
|
gtin | string |
Número de item do comércio global |
|
NMP
|
mpn | string |
Número de peça do fabricante |
|
reviews_rating_sum
|
reviews_rating_sum | integer |
A classificação total do produto. |
|
reviews_count
|
reviews_count | integer |
O número de vezes que o produto foi classificado. |
|
total_sold
|
total_sold | integer |
A quantidade total deste produto vendido. |
|
custom_fields
|
custom_fields | array of productCustomField_Put | |
|
bulk_pricing_rules
|
bulk_pricing_rules | array of bulkPricingRule_Full | |
|
images
|
images | array of productImage_Full | |
|
videos
|
videos | array of productVideo_Full |
product_Full
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
product_Base
|
schema | product_Base | |
|
date_created
|
date_created | date-time |
A data em que o produto foi criado. |
|
date_modified
|
date_modified | date-time |
A data em que o produto foi modificado. |
|
id
|
id | integer |
ID do produto. Somente leitura. |
|
base_variant_id
|
base_variant_id | integer |
O identificador único da variante de base associada a um produto simples. Este valor é |
|
calculated_price
|
calculated_price | double |
O preço do produto como visto na vitrine. Será igual ao |
|
options
|
options | array of productOption_Base | |
|
modificadores
|
modifiers | array of productModifier_Full | |
|
option_set_id
|
option_set_id | integer |
Indica que o produto está em um conjunto de opções (conceito V2 herdado). |
|
option_set_display
|
option_set_display | string |
Configuração de modelo herdado que controla se o conjunto de opções aparece ao lado ou abaixo da imagem e descrição do produto. |
|
productVariant_Full
|
variants | productVariant_Full |
ProductCollectionResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of product_Full | |
|
metaCollection_Full
|
meta | metaCollection_Full |
Dados sobre a resposta, incluindo paginação e totais de coleta. |
productCustomField_Put
Obtém campos personalizados associados a um produto. Eles permitem que você especifique informações adicionais que aparecerão na página do produto, como o ISBN de um livro ou a data de lançamento de um DVD.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer |
A ID numérica exclusiva do campo personalizado; incrementos sequenciais. Necessário para atualizar o campo personalizado existente na solicitação /PUT. Read-Only |
|
nome
|
name | string |
O nome do campo, mostrado na vitrine, pedidos, etc. Necessário para /POST |
|
valor
|
value | string |
O nome do campo, mostrado na vitrine, pedidos, etc. Necessário para /POST |
productImage_Full
Propriedades comuns de ProductImage.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
image_file
|
image_file | string |
O caminho local para o arquivo de imagem original carregado no BigCommerce. |
|
is_thumbnail
|
is_thumbnail | boolean |
Sinalizador para identificar se a imagem é usada como miniatura do produto. |
|
sort_order
|
sort_order | integer |
A ordem em que a imagem será exibida na página do produto. Números inteiros mais altos dão à imagem uma prioridade menor. Ao atualizar, se for dada uma prioridade menor à imagem, todas as imagens com um |
|
descrição
|
description | string |
A descrição da imagem. |
|
image_url
|
image_url | string |
Deve ser um caminho de URL totalmente qualificado, incluindo protocolo. Limite de 8MB por ficheiro. |
|
id
|
id | integer |
O ID numérico exclusivo da imagem; incrementos sequenciais. |
|
product_id
|
product_id | integer |
O identificador numérico exclusivo do produto ao qual a imagem está associada. |
|
url_zoom
|
url_zoom | string |
O URL de zoom para esta imagem. Por padrão, isso é usado como a imagem de zoom em páginas de produtos quando as imagens de zoom estão habilitadas. |
|
url_standard
|
url_standard | string |
O URL padrão para esta imagem. Por padrão, isso é usado para imagens de página de produto. |
|
url_thumbnail
|
url_thumbnail | string |
O URL da miniatura desta imagem. Por padrão, esse é o tamanho da imagem usado na página de categoria e nos painéis laterais. |
|
url_tiny
|
url_tiny | string |
O pequeno URL para esta imagem. Por padrão, esse é o tamanho da imagem usado para miniaturas abaixo da imagem do produto em uma página do produto. |
|
date_modified
|
date_modified | date-time |
A data em que a imagem do produto foi modificada. |
productModifier_Base
Propriedades comuns do modificador.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
tipo
|
type | string |
API do BigCommerce, que determina como ele será exibido na vitrine. Valores aceitáveis: |
|
required
|
required | boolean |
Se este modificador é ou não necessário no checkout. Obrigatório em um /POST. |
|
sort_order
|
sort_order | integer |
A ordem que os modificadores exibem na página de detalhes do produto. |
|
config_Full
|
config | config_Full |
Os valores para configuração de opção podem variar com base no modificador criado. |
|
display_name
|
display_name | string |
O nome da opção mostrada na vitrine. |
productModifier_Full
Modificador de produto
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
productModifier_Base
|
schema | productModifier_Base |
Propriedades comuns do modificador. |
|
id
|
id | integer |
A ID numérica exclusiva do modificador; incrementos sequenciais. |
|
product_id
|
product_id | integer |
O ID numérico exclusivo do produto ao qual a opção pertence. |
|
nome
|
name | string |
O nome exclusivo da opção. Gerado automaticamente a partir do nome para exibição, um carimbo de data/hora e o ID do produto. |
|
option_values
|
option_values | array of productModifierOptionValue_Full |
productModifierOptionValue_Full
Produto Modifer option_value.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
is_default
|
is_default | boolean |
O sinalizador para pré-selecionar um valor como padrão na vitrine. Este campo não é suportado para opções/modificadores de amostras. |
|
etiqueta
|
label | string |
O texto é exibido identificando o valor na vitrine. Obrigatório em um /POST. |
|
sort_order
|
sort_order | integer |
A ordem em que o valor será exibido na página do produto. Obrigatório em um /POST. |
|
value_data
|
value_data | object |
Dados adicionais que descrevem o valor, com base no tipo de opção ou modificador ao qual o valor está associado. A |
|
adjusters_Full
|
adjusters | adjusters_Full | |
|
id
|
id | integer |
A ID numérica exclusiva do valor; incrementos sequenciais. |
|
option_id
|
option_id | integer |
productOption_Base
Propriedades de opção comum.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer |
O ID numérico exclusivo da opção, incrementa sequencialmente. |
|
product_id
|
product_id | integer |
O ID numérico exclusivo do produto ao qual a opção pertence. |
|
display_name
|
display_name | string |
O nome da opção mostrada na vitrine. |
|
tipo
|
type | string |
O tipo de opção, que determina como ela será exibida na vitrine. Valores aceitáveis: |
|
productOptionConfig_Full
|
config | productOptionConfig_Full |
Os valores para configuração de opção podem variar com base no modificador criado. |
|
sort_order
|
sort_order | integer |
Ordem em que a opção é exibida na vitrine. |
|
productOptionOptionValue_Full
|
option_values | productOptionOptionValue_Full |
Opção do |
productOptionConfig_Full
Os valores para configuração de opção podem variar com base no modificador criado.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
default_value
|
default_value | string |
(data, texto, multi_line_text numbers_only_text) O valor padrão. Mostrado em uma opção de data como uma cadeia de caracteres formatada em ISO-8601 ou em uma opção de texto como uma cadeia de caracteres. |
|
checked_by_default
|
checked_by_default | boolean |
(caixa de verificação) Sinalizador para definir a caixa de seleção a ser marcada por padrão. |
|
checkbox_label
|
checkbox_label | string |
(caixa de verificação) Rótulo exibido para a opção de caixa de seleção. |
|
date_limited
|
date_limited | boolean |
(data) Sinalizador para limitar as datas permitidas para serem inseridas em uma opção de data. |
|
date_limit_mode
|
date_limit_mode | string |
(data) O tipo de limite que pode ser inserido em uma opção de data. |
|
date_earliest_value
|
date_earliest_value | date |
(data) A data mais antiga permitida pode ser inserida na opção de data, como uma cadeia de caracteres formatada ISO-8601. |
|
date_latest_value
|
date_latest_value | date |
(data) A última data permitida pode ser inserida na opção de data, como uma cadeia de caracteres formatada ISO-8601. |
|
file_types_mode
|
file_types_mode | string |
(ficheiro) O tipo de restrição sobre os tipos de arquivo que podem ser carregados com uma opção de upload de arquivo. Valores: |
|
file_types_supported
|
file_types_supported | array of string |
(ficheiro) O tipo de arquivos que podem ser carregados se o |
|
file_types_other
|
file_types_other | array of string |
(ficheiro) Uma lista de outros tipos de arquivo permitidos com a opção de upload de arquivo. |
|
file_max_size
|
file_max_size | integer |
(ficheiro) O tamanho máximo de um arquivo que pode ser usado com a opção de upload de arquivo. Isso ainda será limitado pelo servidor. |
|
text_characters_limited
|
text_characters_limited | boolean |
(texto, multi_line_text) Sinalizador para validar o comprimento de um texto ou entrada de texto com várias linhas. |
|
text_min_length
|
text_min_length | integer |
(texto, multi_line_text) O comprimento mínimo permitido para uma opção de texto ou texto com várias linhas. |
|
text_max_length
|
text_max_length | integer |
(texto, multi_line_text) O comprimento máximo permitido para uma opção de texto ou texto de várias linhas. |
|
text_lines_limited
|
text_lines_limited | boolean |
(multi_line_text) Sinalizador para validar o número máximo de linhas permitido em uma entrada de texto com várias linhas. |
|
text_max_lines
|
text_max_lines | integer |
(multi_line_text) O número máximo de linhas permitido em uma entrada de texto com várias linhas. |
|
number_limited
|
number_limited | boolean |
(numbers_only_text) Sinalizador para limitar o valor de uma opção de número. |
|
number_limit_mode
|
number_limit_mode | string |
(numbers_only_text) O tipo de limite de valores inseridos para uma opção de número. |
|
number_lowest_value
|
number_lowest_value | double |
(numbers_only_text) O menor valor permitido para uma opção de número se |
|
number_highest_value
|
number_highest_value | double |
(numbers_only_text) O valor mais alto permitido para uma opção de número, se |
|
number_integers_only
|
number_integers_only | boolean |
(numbers_only_text) Sinalizador para limitar a entrada em uma opção de número apenas a números inteiros. |
|
product_list_adjusts_inventory
|
product_list_adjusts_inventory | boolean |
(product_list, product_list_with_images) Sinalizador para ajustar automaticamente o inventário de um produto incluído na lista. |
|
product_list_adjusts_pricing
|
product_list_adjusts_pricing | boolean |
(product_list, product_list_with_images) Sinalizar para adicionar o preço do produto opcional ao preço do produto principal. |
|
product_list_shipping_calc
|
product_list_shipping_calc | string |
(product_list, product_list_with_images) Como considerar o peso do produto opcional e as dimensões da embalagem na cotação de envio. Valores: |
productOptionOptionValue_Full
Opção do option_valueproduto .
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
is_default
|
is_default | boolean |
O sinalizador para pré-selecionar um valor como padrão na vitrine. Este campo não é suportado para opções/modificadores de amostras. |
|
etiqueta
|
label | string |
O texto é exibido identificando o valor na vitrine. Obrigatório em um /POST. |
|
sort_order
|
sort_order | integer |
A ordem em que o valor será exibido na página do produto. Obrigatório em um /POST. |
|
value_data
|
value_data | object |
Dados adicionais que descrevem o valor, com base no tipo de opção ou modificador ao qual o valor está associado. A |
|
id
|
id | integer |
A ID numérica exclusiva do valor; incrementos sequenciais. |
ProductResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
product_Full
|
data | product_Full | |
|
meta
|
meta | object |
Meta objeto vazio; pode ser utilizado mais tarde. |
products_Resource
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
URL
|
url | string | |
|
recurso
|
resource | string |
productVariant_Full
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
cost_price
|
cost_price | double |
O preço de custo da variante. Não afetado pelos preços de tabela de preços. |
|
Preço
|
price | double |
O preço base desta variante na montra. Se for utilizado um ID da Lista de Preços, será utilizado o valor da Lista de Preços. Se um ID da Lista de Preços não for usado, e esse valor for |
|
sale_price
|
sale_price | double |
O preço de venda desta variante na montra. Se for utilizado um ID da Lista de Preços, será utilizado o valor da Lista de Preços. Se um ID da Lista de Preços não for usado e esse valor for nulo, o preço de venda do produto (definido no campo do recurso do |
|
retail_price
|
retail_price | double |
O preço de retalho desta variante na montra. Se for utilizado um ID da Lista de Preços, será utilizado o valor da Lista de Preços. Se um ID da Lista de Preços não for usado e esse valor for nulo, o preço de varejo do produto (definido no campo do recurso do |
|
weight
|
weight | double |
O peso base desta variante na montra. Se esse valor for nulo, o peso padrão do produto (definido no campo de peso do recurso do produto) será usado como o peso base. |
|
Largura
|
width | double |
Largura da variante, que pode ser usada para calcular os custos de envio. Se esse valor for |
|
altura
|
height | double |
Altura da variante, que pode ser usada para calcular os custos de envio. Se esse valor for |
|
profundidade
|
depth | double |
Profundidade da variante, que pode ser usada para calcular os custos de envio. Se esse valor for |
|
is_free_shipping
|
is_free_shipping | boolean |
Bandeira usada para indicar se a variante tem frete grátis. Se |
|
fixed_cost_shipping_price
|
fixed_cost_shipping_price | double |
Um custo de envio fixo para a variante. Se definido, este valor será usado durante o checkout em vez do cálculo normal do custo de envio. |
|
purchasing_disabled
|
purchasing_disabled | boolean |
Se |
|
purchasing_disabled_message
|
purchasing_disabled_message | string |
Se |
|
UPC
|
upc | string |
O código UPC usado em feeds para sites de comparação de compras e integrações de canais externos. |
|
inventory_level
|
inventory_level | integer |
Nível de estoque para a variante, que é usado quando a inventory_tracking do produto é definida como |
|
inventory_warning_level
|
inventory_warning_level | integer |
Quando a variante atinge esse nível de estoque, é considerado estoque baixo. |
|
bin_picking_number
|
bin_picking_number | string |
Identifica onde em um armazém a variante está localizada. |
|
NMP
|
mpn | string |
O número de peça do fabricante (MPN) para a variante. |
|
id
|
id | integer | |
|
product_id
|
product_id | integer | |
|
sku
|
sku | string | |
|
sku_id
|
sku_id | integer |
Referência somente leitura à ID de SKU da API v2. Nulo se for uma variante base. |
|
option_values
|
option_values | array of productVariantOptionValue_Full |
Matriz de IDs de valores de opção e opção que compõem essa variante. Estará vazio se a variante for a variante base do produto. |
|
calculated_price
|
calculated_price | double |
O preço da variante como visto na vitrine. Este preço tem em conta |
|
calculated_weight
|
calculated_weight | double |
productVariantOptionValue_Full
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
option_display_name
|
option_display_name | string |
O nome da opção. |
|
etiqueta
|
label | string |
O rótulo do valor da opção. |
|
id
|
id | integer |
|
|
option_id
|
option_id | integer |
|
productVideo_Base
O modelo de um POST para criar um vídeo sobre um produto.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
title
|
title | string |
O título do vídeo. Se deixado em branco, será preenchido de acordo com os dados de um site anfitrião. |
|
descrição
|
description | string |
A descrição do vídeo. Se deixado em branco, será preenchido de acordo com os dados de um site anfitrião. |
|
sort_order
|
sort_order | integer |
A ordem em que o vídeo será exibido na página do produto. Números inteiros mais altos dão ao vídeo uma prioridade menor. Ao atualizar, se for dada uma prioridade menor ao vídeo, todos os vídeos com um |
|
tipo
|
type | string |
O tipo de vídeo (um nome curto de um site host). |
|
video_id
|
video_id | string |
O ID do vídeo em um site host. |
productVideo_Full
Um modelo de vídeo de produto.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
productVideo_Base
|
schema | productVideo_Base |
O modelo de um POST para criar um vídeo sobre um produto. |
|
id
|
id | integer |
O ID numérico exclusivo do vídeo do produto; incrementos sequenciais. |
|
product_id
|
product_id | integer |
O identificador numérico exclusivo do produto ao qual a imagem está associada. |
|
length
|
length | string |
Duração do vídeo. Este será preenchido de acordo com os dados de um site anfitrião. |
ComprandoDesabilitado
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | boolean |
Sinalize se o valor do modificador desabilita a compra quando selecionado na vitrine. Isso pode ser usado para desativar temporariamente um determinado valor modificador. |
|
mensagem
|
message | string |
A mensagem exibida na vitrine quando o status de compra desativado é |
shippingAddress_Base
Propriedades do endereço de envio comuns a todas as solicitações e respostas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
first_name
|
first_name | string | |
|
last_name
|
last_name | string | |
|
Companhia
|
company | string | |
|
street_1
|
street_1 | string |
Endereço (primeira linha). |
|
street_2
|
street_2 | string |
Endereço (segunda linha). |
|
city
|
city | string | |
|
state
|
state | string | |
|
ZIP
|
zip | string |
CEP ou código postal, como uma string. |
|
country
|
country | string | |
|
country_iso2
|
country_iso2 | string |
Código ISO Alpha-2 de 2 letras para o país. |
|
phone
|
phone | string |
Número de telefone do destinatário. |
|
e-mail
|
string |
Endereço de e-mail do destinatário. |
|
|
shipping_method
|
shipping_method | string |
Código de texto que identifica o módulo de envio do BigCommerce selecionado pelo cliente. |
shippingAddress_Resource
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
URL
|
url | string |
URL do endereço de entrega para solicitações de api |
|
recurso
|
resource | string |
shippingQuotes_Resource
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
URL
|
url | string |
Este URL retornará um 204 para cotações de envio. Para devolver cotações de envio:'/shipping_addresses/shipping_address_id/shipping_quotes'. |
|
recurso
|
resource | string |
Este URL retornará um 204 para cotações de envio. Para devolver cotações de envio:'/shipping_addresses/shipping_address_id/shipping_quotes'. |
PagamentoStatus
Um valor somente leitura. Não tente definir ou modificar esse valor em uma operação POST ou PUT.
Um valor somente leitura. Não tente definir ou modificar esse valor em uma operação POST ou PUT.
- PagamentoStatus
- string
Método de Pagamento
O método de pagamento para esta encomenda. Pode ser um dos seguintes: Manual, Credit Card, , cash, Test Payment Gatewayetc.
O método de pagamento para esta encomenda. Pode ser um dos seguintes: Manual, Credit Card, , cash, Test Payment Gatewayetc.
- Método de Pagamento
- string
TaxProviderId
BasicTaxProvider - O imposto é definido como manual.
AvaTaxProvider - Isso é para quando o provedor de impostos foi definido como automático e o pedido NÃO foi criado pela API. Usado para Avalara.
"" (em branco) - Quando o provedor fiscal é desconhecido. Isso inclui pedidos legados e pedidos criados anteriormente via API. Isso pode ser definido ao criar um pedido usando um POST.
BasicTaxProvider - O imposto é definido como manual.
AvaTaxProvider - Isso é para quando o provedor de impostos foi definido como automático e o pedido NÃO foi criado pela API. Usado para Avalara.
"" (em branco) - Quando o provedor fiscal é desconhecido. Isso inclui pedidos legados e pedidos criados anteriormente via API. Isso pode ser definido ao criar um pedido usando um POST.
- TaxProviderId
- string