Esquemas de dados
Endereço de entrega
AddressData · Esquema · Esquemas de dados: Pedidos
address_line_1Texto nullObrigatórioPrimeira linha de endereço.
address_line_2Texto nullObrigatórioInformações adicionais do endereço.
cityTexto nullObrigatórioCidade ou localidade.
country_codeTexto nullObrigatórioCódigo do país.
first_nameTexto nullObrigatórioNome.
house_numberTexto nullObrigatórioNúmero do edifício ou da casa.
last_nameTexto nullObrigatórioApelido.
phoneTexto nullObrigatórioNúmero de telefone.
postal_codeTexto nullObrigatórioCódigo postal.
regionTexto nullObrigatórioRegião administrativa.
streetTexto nullObrigatórioNome da rua.
Campos adicionais: Não
ApiResponse_OrderFileListData_
ApiResponse_OrderFileListData_ · Campos, tipos e restrições dos dados aceites ou devolvidos pela API. Envie os ficheiros como multipart/form-data após criar upload_id e associe-os ao produto. A transferência exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem palavra-passe. Para mode=period escolha days (1–3650) ou o anterior months, nunca ambos. As condições ficam registadas na compra; o reembolso retira o acesso apenas à linha reembolsada.
dataOrderFileListDataObrigatórioConteúdo de uma resposta bem-sucedida.
metaContextPageMetaContextMetaPageMetaRequestMetaObrigatórioMetadados da resposta.
Campos adicionais: Não
ApiResponse_OrderReleaseListData_
ApiResponse_OrderReleaseListData_ · Campos, tipos e restrições dos dados aceites ou devolvidos pela API. Envie os ficheiros como multipart/form-data após criar upload_id e associe-os ao produto. A transferência exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem palavra-passe. Para mode=period escolha days (1–3650) ou o anterior months, nunca ambos. As condições ficam registadas na compra; o reembolso retira o acesso apenas à linha reembolsada.
dataOrderReleaseListDataObrigatórioConteúdo de uma resposta bem-sucedida.
metaContextPageMetaContextMetaPageMetaRequestMetaObrigatórioMetadados da resposta.
Campos adicionais: Não
Listar — Pedidos — Resposta
ApiResponse_list_OrderSummaryData__ · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
dataLista <OrderSummaryData> ObrigatórioExemplo de resposta · ApiResponse_list_OrderSummaryData__.
metaContextPageMetaContextMetaPageMetaRequestMetaObrigatórioMetadados da resposta.
Campos adicionais: Não
Obter — Pedidos — Resposta
ApiResponse_OrderDetailData_ · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
dataOrderDetailDataObrigatórioExemplo de resposta · OrderDetailData.
metaContextPageMetaContextMetaPageMetaRequestMetaObrigatórioMetadados da resposta.
Campos adicionais: Não
CurrentReleaseData
CurrentReleaseData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API. Envie os ficheiros como multipart/form-data após criar upload_id e associe-os ao produto. A transferência exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem palavra-passe. Para mode=period escolha days (1–3650) ou o anterior months, nunca ambos. As condições ficam registadas na compra; o reembolso retira o acesso apenas à linha reembolsada.
acquiredBooleanoObrigatórioAcesso após a compra (true / false)
changelogTextoObrigatórioDescrição das alterações
covered_by_purchaseBooleanoObrigatórioAcesso após a compra (true / false)
idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado.
published_atTextoObrigatórioPublicar versão · UTC
format:"date-time"requires_new_purchaseBooleanoObrigatórioSem acesso a ficheiros adicionados após a compra · requires_new_purchase
sequenceNúmero inteiroObrigatórioPosição na coleção ordenada.
version_labelTextoObrigatórioVersão
Campos adicionais: Não
Informações do cliente registadas para este recurso
CustomerData · Esquema · Esquemas de dados: Pedidos
emailTextoObrigatórioEndereço de e-mail.
first_nameTexto nullObrigatórioNome.
last_nameTexto nullObrigatórioApelido.
phoneTexto nullObrigatórioNúmero de telefone.
Campos adicionais: Não
DeliveryContentDeletion
DeliveryContentDeletion · Exclua o conteúdo definitivamente, preservando o histórico. O código não volta ao stock disponível.
expected_versionNúmero inteiroObrigatórioVersão lida antes da escrita; uma divergência rejeita a atualização.
minimum:1reasonTextoObrigatórioMotivo registado para a alteração.
minLength:1maxLength:500
Campos adicionais: Não
Datas de envio e entrega
DeliveryDatesData · A lista e os detalhes dos pedidos incluem delivery.dates. As datas YYYY-MM-DD são previstas e não confirmam o envio. As datas atuais têm prioridade; pedidos antigos usam a estimativa guardada. Valores apagados ou desconhecidos são null. Os detalhes incluem também todas as linhas e imagens dos produtos.
dispatch_timezoneTexto nullObrigatórioFuso horário do envio (IANA; null).
estimated_delivery_fromTexto nullObrigatórioInício da entrega estimada (YYYY-MM-DD; null).
Texto:format:"date"estimated_delivery_toTexto nullObrigatórioFim da entrega estimada (YYYY-MM-DD; null).
Texto:format:"date"planned_dispatch_onTexto nullObrigatórioData de envio prevista (YYYY-MM-DD; null).
Texto:format:"date"
Campos adicionais: Não
DeliveryReplacement
DeliveryReplacement · Escolha uma unidade livre existente. A substituição não reinicia o prazo de armazenamento.
expected_unit_versionNúmero inteiroObrigatórioVersão atual da unidade livre de substituição.
minimum:1expected_versionNúmero inteiroObrigatórioVersão lida antes da escrita; uma divergência rejeita a atualização.
minimum:1reasonTextoObrigatórioMotivo registado para a alteração.
minLength:1maxLength:500replacement_unit_idTextoObrigatórioID de uma unidade livre existente para substituição.
format:"uuid"
Campos adicionais: Não
DeliveryPickupPointData
DeliveryPickupPointData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
addressPickupPointAddressDataObrigatórioEndereço de entrega.
codeTextoObrigatórioCódigo estável legível por programas.
Restrições
pattern"^[A-Za-z0-9_-]{1,63}$"
coordinatesPickupPointCoordinatesDatanullObrigatórioValor definido pelo esquema que o contém.
country_codeTextoObrigatórioCódigo do país.
Restrições
pattern"^[A-Z]{2}$"
environmentTextoObrigatórioInformações do ambiente associadas ao registo.
Restrições
enum["live", "sandbox"]
kindTextoObrigatórioVariante da estrutura de dados definida pelos valores permitidos.
Restrições
enum["locker", "pickup_point"]
location_descriptionTexto nullObrigatórioDescrição no idioma selecionado.
Texto:maxLength:1000nameTextoObrigatórioNome do recurso no contexto correspondente.
minLength:1maxLength:160opening_hoursTexto nullObrigatórioOpening hours
Texto:maxLength:500operatorTextoObrigatórioNome do recurso no contexto correspondente.
minLength:1maxLength:63verified_atTextoObrigatórioMomento da atualização mais recente.
format:"date-time"
Campos adicionais: Não
ApiResponse[list[DeliveryData]]
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_DeliveryData____1 · Consulte as unidades atribuídas sem revelar os códigos. O reembolso retira o acesso apenas dos itens afetados.
dataLista <shopently_engine__domains__orders__adapters__public_http__digital_deliveries__schemas__DeliveryData> ObrigatórioConteúdo de uma resposta bem-sucedida.
metaContextPageMetaContextMetaPageMetaRequestMetaObrigatórioMetadados da resposta.
Campos adicionais: Não
DeliveryData
shopently_engine__domains__orders__adapters__public_http__digital_deliveries__schemas__DeliveryData · Consulte as unidades atribuídas sem revelar os códigos. O reembolso retira o acesso apenas dos itens afetados.
can_downloadBooleanoObrigatórioDescarregar (true / false)
content_stateTextoObrigatórioEstado do conteúdo: present / deleting / deleted.
delete_due_atTexto nullObrigatórioExclusão programada do ficheiro; null a desativa.
Texto:format:"date-time"filenameTexto nullObrigatórioFicheiro
first_available_atTexto nullObrigatórioPrimeiro acesso desta compra; a substituição não reinicia o prazo.
Texto:format:"date-time"generationNúmero inteiroObrigatórioGeração da atribuição; aumenta na substituição.
idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado.
format:"uuid"kindTexto nullObrigatórioVariante da estrutura de dados definida pelos valores permitidos.
line_idTextoObrigatórioIdentificador estável da linha da encomenda.
order_idTextoObrigatórioIdentificador do pedido relacionado.
payload_idTextoObrigatórioID do conteúdo; não é uma URL pública de download.
format:"uuid"product_idTextoObrigatórioIdentificador do produto.
reasonTextoObrigatórioMotivo registado para a alteração.
size_bytesNúmero inteiro nullObrigatórioTamanho em bytes
stateTextoObrigatórioEstado
unit_idTextoObrigatórioID de um código ou ficheiro individual.
format:"uuid"unit_ordinalNúmero inteiroObrigatórioNúmero da unidade comprada dentro do item do encomenda.
variant_idTexto nullObrigatórioIdentificador da variante do produto.
versionNúmero inteiroObrigatórioVersão do recurso utilizada para controlo de concorrência.
Campos adicionais: Não
Informações da fatura
InvoiceData · Esquema · Esquemas de dados: Pedidos
address_line_1Texto nullObrigatórioPrimeira linha de endereço.
address_line_2Texto nullObrigatórioInformações adicionais do endereço.
cityTexto nullObrigatórioCidade ou localidade.
company_nameTexto nullObrigatórioNome da empresa.
country_codeTexto nullObrigatórioCódigo do país.
house_numberTexto nullObrigatórioNúmero do edifício ou da casa.
postal_codeTexto nullObrigatórioCódigo postal.
regionTexto nullObrigatórioRegião administrativa.
streetTexto nullObrigatórioNome da rua.
tax_identifierTexto nullObrigatórioNúmero de identificação fiscal.
tax_schemeTexto nullObrigatórioEsquema de cálculo de impostos.
Campos adicionais: Não
Montante líquido / Montante do imposto / Montante bruto
OrderAmountBreakdownData · Os montantes e taxas vêm da encomenda guardada, incluindo correções das linhas. Dados históricos em falta são null e não são substituídos pelas taxas atuais do catálogo. Os montantes continuam a ser textos decimais.
grossMoneyDataObrigatórioMontante bruto · Após os descontos; Desconhecido: null; zero conhecido: 0.
netMoneyDatanullObrigatórioMontante líquido · Após os descontos; Desconhecido: null; zero conhecido: 0.
taxMoneyDatanullObrigatórioMontante do imposto · Após os descontos; Desconhecido: null; zero conhecido: 0.
Campos adicionais: Não
Envio · Descontos
OrderDeliveryDiscountData · Os montantes e taxas vêm da encomenda guardada, incluindo correções das linhas. Dados históricos em falta são null e não são substituídos pelas taxas atuais do catálogo. Os montantes continuam a ser textos decimais.
amountMoneyDataObrigatórioMontante bruto · Envio · Descontos.
campaign_idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado.
codeTexto nullObrigatórioCódigo estável legível por programas.
kindTextoObrigatórioVariante da estrutura de dados definida pelos valores permitidos.
Restrições
enum["coupon", "promotion"]
nameTextoObrigatórioNome do recurso no contexto correspondente.
sequenceNúmero inteiro nullObrigatórioPosição na coleção ordenada.
versionNúmero inteiroObrigatórioVersão do recurso utilizada para controlo de concorrência.
Campos adicionais: Não
Obter — Pedidos — Resposta
OrderDetailData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
created_atTextoObrigatórioMomento da criação.
format:"date-time"customerCustomerDataObrigatórioInformações do cliente registadas para este recurso.
deliveryShippingDetailDataObrigatórioMétodo de entrega e informações associadas.
discount_amountMoneyDataObrigatórioValor decimal codificado como texto JSON; null apenas quando permitido.
discountsLista <OrderDiscountData> ObrigatórioDescontos
idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. (OrderDetailData).
invoiceInvoiceDatanullObrigatórioInformações da fatura.
invoice_requestedBooleanoObrigatórioIndica se foi solicitada uma fatura.
lifecycle_stateOrderLifecycleStateObrigatórioEstado do ciclo de vida do recurso.
linesLista <OrderLineData> ObrigatórioDados das linhas do pedido preservados no momento do registo.
localeTextoObrigatórioIdioma selecionado para esta requisição.
market_idTextoObrigatórioIdentificador do mercado retornado pelo endpoint de contexto.
numberTextoObrigatórioNúmero do pedido ou da solicitação exibido ao utilizador.
paymentPaymentDataObrigatórioDetalhes do pagamento registados no pedido.
pickup_pointPickupPointDatanullObrigatórioPonto de recolha
prices_include_taxBooleanoObrigatórioIndica se os preços da lista incluem impostos.
shipping_addressAddressDatanullObrigatórioEndereço de entrega.
shipping_discount_amountMoneyDataObrigatórioValor decimal codificado como texto JSON; null apenas quando permitido.
statusOrderStatusDataObrigatórioEstado aceito por esta operação específica.
subtotalMoneyDataObrigatórioValor anterior aos componentes adicionais indicados na resposta.
taxMoneyDataObrigatórioInformações fiscais.
tax_breakdownOrderTaxBreakdownDataObrigatórioGrupos fiscais · source + tax_rate; unallocated_tax.
tax_country_codeTexto nullObrigatórioPaís fiscal · Dados guardados da encomenda · ISO 3166-1 alpha-2; null.
totalMoneyDataObrigatórioValor total.
totalsOrderTotalsDataObrigatórioTotais · net / tax / gross; Antes dos descontos / Após os descontos.
Campos adicionais: Não
OrderFileData
OrderFileData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API. Envie os ficheiros como multipart/form-data após criar upload_id e associe-os ao produto. A transferência exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem palavra-passe. Para mode=period escolha days (1–3650) ou o anterior months, nunca ambos. As condições ficam registadas na compra; o reembolso retira o acesso apenas à linha reembolsada.
can_downloadBooleanoObrigatórioDescarregar (true / false)
categoryFileCategoryObrigatórioCategoria do ficheiro: internal / customer_document / digital
filenameTextoObrigatórioFicheiro
idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado.
labelTextoObrigatórioNome do recurso no contexto correspondente.
line_idTextoObrigatórioIdentificador estável da linha da encomenda.
mime_typeTextoObrigatórioTipo de conteúdo da multimédia.
product_idTextoObrigatórioIdentificador do produto.
purchase_idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. · purchase_id
reasonTextoObrigatórioMotivo registado para a alteração.
sha256TextoObrigatórioSHA-256 (hex, 64)
size_bytesNúmero inteiroObrigatórioTamanho em bytes
minimum:1maximum:262144000source_file_idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. · source_file_id
source_version_idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. · source_version_id
source_version_numberNúmero inteiroObrigatórioVersão
minimum:1stateTextoObrigatórioEstado
Campos adicionais: Não
OrderFileListData
OrderFileListData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API. Envie os ficheiros como multipart/form-data após criar upload_id e associe-os ao produto. A transferência exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem palavra-passe. Para mode=period escolha days (1–3650) ou o anterior months, nunca ambos. As condições ficam registadas na compra; o reembolso retira o acesso apenas à linha reembolsada.
filesLista <OrderFileData> ObrigatórioFicheiros do produto
updates_pendingBooleanoObrigatórioAcesso a ficheiros futuros após a compra · updates_pending
Campos adicionais: Não
Metadados e URL da imagem
OrderImageData · Esquema · Esquemas de dados: Pedidos
altTexto nullObrigatórioTexto alternativo de uma imagem.
sourceTextoOpcionalOrigem da atividade registada.
const:"current_catalog"urlTextoObrigatórioURL do recurso.
Campos adicionais: Não
Estado do ciclo de vida do recurso
OrderLifecycleState · Esquema · Esquemas de dados: Pedidos
TextoRestrições
enum["placed", "cancelled", "fulfilled", "returned"]
Campos adicionais: Sim
Dados das linhas do pedido preservados no momento do registo
OrderLineData · Esquema · Esquemas de dados: Pedidos
discount_amountMoneyDataObrigatórioValor decimal codificado como texto JSON; null apenas quando permitido.
discount_grossMoneyDataObrigatórioMontante bruto · Descontos; Desconhecido: null; zero conhecido: 0.
discount_netMoneyDatanullObrigatórioMontante líquido · Descontos; Desconhecido: null; zero conhecido: 0.
discount_taxMoneyDatanullObrigatórioMontante do imposto · Descontos; Desconhecido: null; zero conhecido: 0.
discountsLista <OrderDiscountData> ObrigatórioDescontos · net / tax / gross.
identifiersObjetoCampos adicionais: TextoObrigatórioCódigos de identificação do produto.
imageOrderImageDatanullObrigatórioMetadados e URL da imagem.
line_idTextoObrigatórioIdentificador estável da linha da encomenda.
manual_discountOrderManualDiscountDatanullObrigatórioDesconto manual; null.
nameTextoObrigatórioNome do recurso no contexto correspondente.
original_totalMoneyDataObrigatórioValor total.
original_total_grossMoneyDataObrigatórioMontante bruto · Produtos · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
original_total_netMoneyDatanullObrigatórioMontante líquido · Produtos · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
original_total_taxMoneyDatanullObrigatórioMontante do imposto · Produtos · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
positionNúmero inteiroObrigatórioPosição na coleção ordenada.
product_idTextoObrigatórioIdentificador do produto.
quantityNúmero inteiroObrigatórioNúmero de unidades.
skuTextoObrigatórioCódigo da unidade de manutenção de stock.
taxMoneyDatanullObrigatórioMontante do imposto · Uma unidade · Dados guardados da encomenda; tax ≠ unit_tax; Desconhecido: null; zero conhecido: 0.
tax_category_idTexto nullObrigatórioIdentificador da categoria fiscal · Dados guardados da encomenda; null.
tax_category_nameTexto nullObrigatórioNome guardado da categoria fiscal; null.
tax_rateTexto nullObrigatóriotax_rate · Dados guardados da encomenda: "0.23" = 23%; "0" ≠ null.
totalMoneyDataObrigatórioValor total.
total_grossMoneyDataObrigatórioMontante bruto · Produtos · Após os descontos; Desconhecido: null; zero conhecido: 0.
total_netMoneyDatanullObrigatórioMontante líquido · Produtos · Após os descontos; Desconhecido: null; zero conhecido: 0.
total_taxMoneyDatanullObrigatórioMontante do imposto · Produtos · Após os descontos · Dados guardados da encomenda; Desconhecido: null; zero conhecido: 0.
unit_grossMoneyDataObrigatórioMontante bruto · Uma unidade · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
unit_netMoneyDatanullObrigatórioMontante líquido · Uma unidade · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
unit_priceMoneyDataObrigatórioPreço por unidade.
unit_taxMoneyDatanullObrigatórioMontante do imposto · Uma unidade · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
variant_idTexto nullObrigatórioIdentificador da variante do produto.
variant_optionsLista <shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData> ObrigatórioOpções de variante associadas ao produto ou aos dados preservados.
Campos adicionais: Não
Desconto manual
OrderManualDiscountData · Os montantes e taxas vêm da encomenda guardada, incluindo correções das linhas. Dados históricos em falta são null e não são substituídos pelas taxas atuais do catálogo. Os montantes continuam a ser textos decimais.
amountMoneyDataObrigatórioMontante bruto · Desconto manual · Dados guardados da encomenda.
kindTextoObrigatórioTipo de desconto: percentage / fixed.
Restrições
enum["percentage", "fixed"]
valueTextoObrigatórioValor configurado: percentage "10" = 10%; fixed = Montante bruto.
Campos adicionais: Não
Estado aceito por esta operação específica
OrderPaymentStatus · Esquema · Esquemas de dados: Pedidos
TextoRestrições
enum["unpaid", "paid", "failed", "refunded"]
Campos adicionais: Sim
OrderReleaseData
OrderReleaseData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API. Envie os ficheiros como multipart/form-data após criar upload_id e associe-os ao produto. A transferência exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem palavra-passe. Para mode=period escolha days (1–3650) ou o anterior months, nunca ambos. As condições ficam registadas na compra; o reembolso retira o acesso apenas à linha reembolsada.
access_reasonTextoObrigatórioAcesso após a compra · Motivo registado para a alteração.
access_stateTextoObrigatórioAcesso após a compra · Estado
current_releaseCurrentReleaseDatanullObrigatórioVersões digitais · current_release
grant_reasonTextoObrigatórioAcesso após a compra · Motivo registado para a alteração.
granted_atTextoObrigatórioAcesso após a compra · UTC
format:"date-time"idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado.
line_idTextoObrigatórioIdentificador estável da linha da encomenda.
manifest_sha256TextoObrigatórioVersões digitais · SHA-256
product_idTextoObrigatórioIdentificador do produto.
published_atTextoObrigatórioPublicar versão · UTC
format:"date-time"purchase_idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. · purchase_id
release_idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. · release_id
release_sequenceNúmero inteiroObrigatórioVersões digitais · Posição na coleção ordenada.
update_daysNúmero inteiro nullObrigatórioNúmero de dias (days; null)
update_modeTextoObrigatórioAcesso a ficheiros futuros após a compra: none / period / unlimited
update_monthsNúmero inteiro nullObrigatórioMeses (months; null)
updates_untilTexto nullObrigatórioAcesso a ficheiros futuros após a compra · UTC
Texto:format:"date-time"version_labelTextoObrigatórioVersão
Campos adicionais: Não
OrderReleaseListData
OrderReleaseListData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API. Envie os ficheiros como multipart/form-data após criar upload_id e associe-os ao produto. A transferência exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem palavra-passe. Para mode=period escolha days (1–3650) ou o anterior months, nunca ambos. As condições ficam registadas na compra; o reembolso retira o acesso apenas à linha reembolsada.
releasesLista <OrderReleaseData> ObrigatórioVersões digitais
updates_pendingBooleanoObrigatórioAcesso a ficheiros futuros após a compra · updates_pending
Campos adicionais: Não
Estado aceito por esta operação específica
OrderStatusData · Esquema · Esquemas de dados: Pedidos
idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. (OrderStatusData).
nameTextoObrigatórioNome do recurso no contexto correspondente.
updated_atTextoObrigatórioMomento da atualização mais recente.
format:"date-time"versionNúmero inteiroObrigatórioVersão do recurso utilizada para controlo de concorrência.
Campos adicionais: Não
Listar · Estados — Pedidos — Resposta
shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
created_atTextoObrigatórioMomento da criação.
format:"date-time"idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. (shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData).
is_initialBooleanoObrigatórioIndica se este é o estado inicial.
nameTextoObrigatórioNome do recurso no contexto correspondente.
positionNúmero inteiroObrigatórioPosição na coleção ordenada.
Campos adicionais: Não
Listar · Estados — Pedidos — Resposta
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1 · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
dataLista <shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData> ObrigatórioExemplo de resposta · shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1.
metaContextPageMetaContextMetaPageMetaRequestMetaObrigatórioMetadados da resposta.
Campos adicionais: Não
Atualizar · Estado — Pedidos — Corpo da requisição
OrderStatusUpdate · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
expected_versionNúmero inteiroObrigatórioVersão lida antes da escrita; uma divergência rejeita a atualização.
minimum:1maximum:9223372036854775807status_idTextoObrigatórioIdentificador obtido do catálogo de estados correspondente.
Restrições
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
Campos adicionais: Não
Listar — Pedidos — Resposta
OrderSummaryData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
created_atTextoObrigatórioMomento da criação.
format:"date-time"customerCustomerDataObrigatórioInformações do cliente registadas para este recurso.
deliveryShippingDataObrigatórioMétodo de entrega e informações associadas.
discount_amountMoneyDataObrigatórioValor decimal codificado como texto JSON; null apenas quando permitido.
idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado. (OrderSummaryData).
lifecycle_stateOrderLifecycleStateObrigatórioEstado do ciclo de vida do recurso.
localeTextoObrigatórioIdioma selecionado para esta requisição.
market_idTextoObrigatórioIdentificador do mercado retornado pelo endpoint de contexto.
numberTextoObrigatórioNúmero do pedido ou da solicitação exibido ao utilizador.
paymentPaymentDataObrigatórioDetalhes do pagamento registados no pedido.
prices_include_taxBooleanoObrigatórioIndica se os preços da lista incluem impostos.
shipping_discount_amountMoneyDataObrigatórioValor decimal codificado como texto JSON; null apenas quando permitido.
statusOrderStatusDataObrigatórioEstado aceito por esta operação específica.
subtotalMoneyDataObrigatórioValor anterior aos componentes adicionais indicados na resposta.
taxMoneyDataObrigatórioInformações fiscais.
tax_country_codeTexto nullObrigatórioPaís fiscal · Dados guardados da encomenda · ISO 3166-1 alpha-2; null.
totalMoneyDataObrigatórioValor total.
Campos adicionais: Não
Encomenda · Grupos fiscais
OrderTaxBreakdownData · Os montantes e taxas vêm da encomenda guardada, incluindo correções das linhas. Dados históricos em falta são null e não são substituídos pelas taxas atuais do catálogo. Os montantes continuam a ser textos decimais.
groupsLista <OrderTaxGroupData> ObrigatórioGrupos fiscais · source + tax_rate; Desconhecido: null; zero conhecido: 0.
unallocated_taxMoneyDataObrigatórioImposto não atribuído = order.tax − Σ groups.tax; ±.
Campos adicionais: Não
Grupos fiscais
OrderTaxGroupData · Os montantes e taxas vêm da encomenda guardada, incluindo correções das linhas. Dados históricos em falta são null e não são substituídos pelas taxas atuais do catálogo. Os montantes continuam a ser textos decimais.
grossMoneyDataObrigatórioMontante bruto · Após os descontos; Desconhecido: null; zero conhecido: 0.
netMoneyDatanullObrigatórioMontante líquido · Após os descontos; Desconhecido: null; zero conhecido: 0.
sourceTextoObrigatórioOrigem: products (Produtos), shipping (Envio).
Restrições
enum["products", "shipping"]
taxMoneyDatanullObrigatórioMontante do imposto · Após os descontos; Desconhecido: null; zero conhecido: 0.
tax_rateTexto nullObrigatóriotax_rate · Dados guardados da encomenda: "0.23" = 23%; "0" ≠ null.
Campos adicionais: Não
Encomenda · Totais
OrderTotalsData · Os montantes e taxas vêm da encomenda guardada, incluindo correções das linhas. Dados históricos em falta são null e não são substituídos pelas taxas atuais do catálogo. Os montantes continuam a ser textos decimais.
before_discountsOrderAmountBreakdownDataObrigatórioEncomenda · Antes dos descontos · net / tax / gross.
discountsOrderAmountBreakdownDataObrigatórioDescontos · net / tax / gross.
orderOrderAmountBreakdownDataObrigatórioEncomenda · Após os descontos · net / tax / gross.
product_discountsOrderAmountBreakdownDataObrigatórioProdutos · Descontos · net / tax / gross.
productsOrderAmountBreakdownDataObrigatórioProdutos · Após os descontos · net / tax / gross.
products_before_discountsOrderAmountBreakdownDataObrigatórioProdutos · Antes dos descontos · net / tax / gross.
shippingOrderAmountBreakdownDataObrigatórioEnvio · Após os descontos · net / tax / gross.
shipping_before_discountsOrderAmountBreakdownDataObrigatórioEnvio · Antes dos descontos · net / tax / gross.
shipping_discountsOrderAmountBreakdownDataObrigatórioEnvio · Descontos · net / tax / gross.
Campos adicionais: Não
Opções de variante associadas ao produto ou aos dados preservados
shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData · Esquema · Esquemas de dados: Pedidos
nameTextoObrigatórioNome do recurso no contexto correspondente.
valueTextoObrigatórioValor definido pelo esquema que o contém.
Campos adicionais: Não
OrderDiscountData
OrderDiscountData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
amountMoneyDataObrigatórioMontante bruto · Produtos · Descontos.
campaign_idTextoObrigatórioIdentificador do recurso; preserve-o conforme retornado.
codeTexto nullObrigatórioCódigo estável legível por programas.
kindTextoObrigatórioVariante da estrutura de dados definida pelos valores permitidos.
Restrições
enum["coupon", "promotion"]
nameTextoObrigatórioNome do recurso no contexto correspondente.
sequenceNúmero inteiro nullOpcionalOrdem de aplicação; null.
shipping_amountMoneyDatanullOpcionalMontante bruto · Envio · Descontos; null.
versionNúmero inteiroObrigatórioVersão do recurso utilizada para controlo de concorrência.
Campos adicionais: Não
Detalhes do pagamento registados no pedido
PaymentData · Esquema · Esquemas de dados: Pedidos
amountMoneyDataObrigatóriopayment.amount é o total da encomenda. O estado do pagamento não determina montantes pagos, reembolsados ou em dívida.
environmentTextoObrigatórioInformações do ambiente associadas ao registo.
Restrições
enum["live", "sandbox"]
method_codeTexto nullObrigatórioCódigo do método de entrega ou pagamento.
method_nameTexto nullObrigatórioNome do método de entrega ou pagamento.
paid_atTexto nullObrigatórioData e hora em que o pagamento foi marcado como pago.
Texto:format:"date-time"statusOrderPaymentStatusObrigatórioEstado aceito por esta operação específica.
updated_atTextoObrigatórioMomento da atualização mais recente.
format:"date-time"versionNúmero inteiroObrigatórioVersão do recurso utilizada para controlo de concorrência.
Campos adicionais: Não
Atualizar · Estado do pagamento — Pedidos — Corpo da requisição
PaymentStatusUpdate · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
expected_versionNúmero inteiroObrigatórioVersão lida antes da escrita; uma divergência rejeita a atualização.
minimum:0maximum:9223372036854775807reasonTextoObrigatórioMotivo registado para a alteração.
minLength:1maxLength:500statusPaymentStatusObrigatórioEstado aceito por esta operação específica. unpaid: por pagar; paid: pago; failed: pagamento falhado; refunded: reembolsado.
Campos adicionais: Não
Estado aceito por esta operação específica
PaymentStatus · Esquema · Esquemas de dados: Pedidos
TextoRestrições
enum["unpaid", "paid", "failed", "refunded"]
Campos adicionais: Sim
PickupPointAddressData
PickupPointAddressData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
address_line_1TextoObrigatórioPrimeira linha de endereço.
minLength:1maxLength:240cityTextoObrigatórioCidade ou localidade.
minLength:1maxLength:160postal_codeTextoObrigatórioCódigo postal.
minLength:1maxLength:32
Campos adicionais: Não
PickupPointCoordinatesData
PickupPointCoordinatesData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
latitudeNúmeroObrigatórioWGS84 φ (°)
minimum:-90.0maximum:90.0longitudeNúmeroObrigatórioWGS84 λ (°)
minimum:-180.0maximum:180.0
Campos adicionais: Não
PickupPointData
PickupPointData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
address_line1TextoObrigatórioPrimeira linha de endereço.
cityTextoObrigatórioCidade ou localidade.
codeTextoObrigatórioCódigo estável legível por programas.
country_codeTextoObrigatórioCódigo do país.
kindTextoObrigatórioVariante da estrutura de dados definida pelos valores permitidos.
Restrições
enum["locker", "pickup_point"]
latitudeNúmero nullObrigatórioWGS84 φ (°)
location_descriptionTexto nullObrigatórioDescrição no idioma selecionado.
longitudeNúmero nullObrigatórioWGS84 λ (°)
nameTextoObrigatórioNome do recurso no contexto correspondente.
opening_hoursTexto nullObrigatórioOpening hours
operatorTextoObrigatórioNome do recurso no contexto correspondente.
postal_codeTextoObrigatórioCódigo postal.
Campos adicionais: Não
PickupPointSummaryData
PickupPointSummaryData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
codeTextoObrigatórioCódigo estável legível por programas.
Restrições
pattern"^[A-Za-z0-9_-]{1,63}$"
country_codeTextoObrigatórioCódigo do país.
Restrições
pattern"^[A-Z]{2}$"
environmentTextoObrigatórioInformações do ambiente associadas ao registo.
Restrições
enum["live", "sandbox"]
kindTextoObrigatórioVariante da estrutura de dados definida pelos valores permitidos.
Restrições
enum["locker", "pickup_point"]
operatorTextoObrigatórioNome do recurso no contexto correspondente.
minLength:1maxLength:63
Campos adicionais: Não
Informações do cliente registadas para este recurso
RequestCustomerData · Esquema · Esquemas de dados: Pedidos
emailTextoObrigatórioEndereço de e-mail.
nameTextoObrigatórioNome do recurso no contexto correspondente.
Campos adicionais: Não
Método de entrega e informações associadas
ShippingData · Esquema · Esquemas de dados: Pedidos
amountMoneyDataObrigatórioMontante bruto do envio registado na encomenda como MoneyData. Alterações fiscais posteriores não alteram este montante histórico.
datesDeliveryDatesDataObrigatórioDatas de envio e entrega. A lista e os detalhes dos pedidos incluem delivery.dates. As datas YYYY-MM-DD são previstas e não confirmam o envio. As datas atuais têm prioridade; pedidos antigos usam a estimativa guardada. Valores apagados ou desconhecidos são null. Os detalhes incluem também todas as linhas e imagens dos produtos.
method_codeTexto nullObrigatórioCódigo do método de entrega ou pagamento.
method_nameTexto nullObrigatórioNome do método de entrega ou pagamento.
pickup_pointPickupPointSummaryDatanullObrigatórioPonto de recolha
recipient_modeTextoObrigatórioVariante da estrutura de dados definida pelos valores permitidos.
Restrições
enum["full_address", "pickup_contact", "address_only", "name_contact", "contact_only"]
Campos adicionais: Não
ShippingDetailData
ShippingDetailData · Campos, tipos e restrições dos dados aceites ou devolvidos pela API.
amountMoneyDataObrigatórioMontante bruto do envio registado na encomenda como MoneyData. Alterações fiscais posteriores não alteram este montante histórico.
datesDeliveryDatesDataObrigatórioDatas de envio e entrega. A lista e os detalhes dos pedidos incluem delivery.dates. As datas YYYY-MM-DD são previstas e não confirmam o envio. As datas atuais têm prioridade; pedidos antigos usam a estimativa guardada. Valores apagados ou desconhecidos são null. Os detalhes incluem também todas as linhas e imagens dos produtos.
discount_grossMoneyDataObrigatórioMontante bruto · Descontos; Desconhecido: null; zero conhecido: 0.
discount_netMoneyDatanullObrigatórioMontante líquido · Descontos; Desconhecido: null; zero conhecido: 0.
discount_taxMoneyDatanullObrigatórioMontante do imposto · Descontos; Desconhecido: null; zero conhecido: 0.
discountsLista <OrderDeliveryDiscountData> nullObrigatórioEnvio · Descontos; []: 0; null: Desconhecido: null; zero conhecido: 0.
grossMoneyDataObrigatórioMontante bruto · Após os descontos; Desconhecido: null; zero conhecido: 0.
method_codeTexto nullObrigatórioCódigo do método de entrega ou pagamento.
method_nameTexto nullObrigatórioNome do método de entrega ou pagamento.
netMoneyDatanullObrigatórioMontante líquido · Após os descontos; Desconhecido: null; zero conhecido: 0.
original_grossMoneyDataObrigatórioMontante bruto · Envio · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
original_netMoneyDatanullObrigatórioMontante líquido · Envio · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
original_taxMoneyDatanullObrigatórioMontante do imposto · Envio · Antes dos descontos; Desconhecido: null; zero conhecido: 0.
pickup_pointDeliveryPickupPointDatanullObrigatórioPonto de recolha
recipient_modeTextoObrigatórioVariante da estrutura de dados definida pelos valores permitidos.
Restrições
enum["full_address", "pickup_contact", "address_only", "name_contact", "contact_only"]
taxMoneyDatanullObrigatórioMontante do imposto · Após os descontos; Desconhecido: null; zero conhecido: 0.
tax_category_idTexto nullObrigatórioIdentificador da categoria fiscal · Dados guardados da encomenda; null.
tax_category_nameTexto nullObrigatórioNome guardado da categoria fiscal; null.
tax_rateTexto nullObrigatóriotax_rate · Dados guardados da encomenda: "0.23" = 23%; "0" ≠ null.
Campos adicionais: Não