Páginas filhas
  • Introdução Hub de Integração TOTVS Moda

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. VISÃO GERAL

...

O Hub de Integração TOTVS Moda é um passo importante para a inovação

...

a ponto de facilitar a sua integração aos diversos segmentos.

Com está nova estrutura

...

será permitida a sua utilização para aplicações existentes ou novas

...

de forma simples e ágil.

Todas as URLs e documentações estão disponíveis no swagger de cada API disponível para acesso através dos host  Base oficial ou Base treino.

...

Após uma vez que você tenha solicitado seu token de acesso ao nosso suporte, é fácil e simples começar a sua integração.

Todos as URL's e documentações swagger estão disponíveis para acesso através do host Base oficial ou Base treino

02. EXEMPLO DE UTILIZAÇÃO

...

tabsRequisição,Exemplo
idsrequisicao,exemplo

...

defaultyes
referenciarequisicao

 

Segurança

O Token de Autorização tem a responsabilidade de autenticar os usuários nas diversas API's,

utilizamos para geração e validação de tokens no padrão Json Web Token (JWT), criptografados, que serão utilizados durante as requisições às API's,

garantindo assim, a autenticidade das informações entre as duas partes (back-end e front-end ou de um back-end para outro back-end).

Outro ponto importante  para verificar a integridade dos dados é a chave de acesso única ou conhecido como "x-api-key",

onde este é gerado exclusivamente para cada cliente e está é obrigatório ser informando em todas as requisições.

Trabalhando juntas e aumentando a segurança e a integridade dos seus dados.


Abaixo temos um exemplo de como gerar o Token de Autorização pelo Postman, importando através de uma cURL.

curl --location --request POST 'https://moda.api.varejo.totvs.com.br/api/totvsmoda/authorization/v2/token' \
--header 'x-api-key;' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'client_id=' \
--data-urlencode 'client_secret=' \
--data-urlencode 'username=' \
--data-urlencode 'password='

Na aba Headers temos o campo x-api-key, onde deve ser inserida a chave de acesso única.

Na aba Body temos os campos onde devem ser inseridas as credenciais do cliente.

Image Added

Lista

Abaixo a lista contendo as API's e o link de sua documentação com suas funcionalidades disponíveis para utilização.



Analytics - Dados de movimentações fiscaisDocumentação
Obter empresas da movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_branch_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_branch_fiscal_movement_search

Obter dados de comprador da movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_buyer_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_buyer_fiscal_movement_search

Obter movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_fiscal_movement_search

Obter dados de operação de movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_operation_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_operation_fiscal_movement_search

Obter dados de condição de pagamento da movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_payment_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_payment_fiscal_movement_search

Obter dados de pessoa da movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_person_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_person_fiscal_movement_search

Obter dados de produto da movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_product_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_product_fiscal_movement_search

Obter dados de representante da movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_representative_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_representative_fiscal_movement_search

Obter dados de vendedor da movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_seller_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_seller_fiscal_movement_search

Obter dados de tipo de saldo da movimentação fiscal

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Analytics/post_api_totvsmoda_analytics_v2_stock_fiscal_movement_search

Produção: https://moda.api.varejo.totvs.com.br/#/Analytics/post_api_totvsmoda_analytics_v2_stock_fiscal_movement_search

GeneralDocumentação
Obter dados de operação

Treino: https://moda.api.varejo.totvs.com.br/treino/#/General/get_api_totvsmoda_general_v2_operations

Produção: https://moda.api.varejo.totvs.com.br/#/General/get_api_totvsmoda_general_v2_operations

Obter dados de condição de pagamento

Treino: https://moda.api.varejo.totvs.com.br/treino/#/General/get_api_totvsmoda_general_v2_payment_conditions

Produção: https://moda.api.varejo.totvs.com.br/#/General/get_api_totvsmoda_general_v2_payment_conditions

Criação de contagem com produtos

Treino: https://moda.api.varejo.totvs.com.br/treino/#/ProductCount/post_api_totvsmoda_general_v2_product_counts

Produção: https://moda.api.varejo.totvs.com.br/#/ProductCount/post_api_totvsmoda_general_v2_product_counts

Incluir relação de classificação em transação existente

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Transaction/post_api_totvsmoda_general_v2_transaction_classification_relationship_create

Produção: https://moda.api.varejo.totvs.com.br/#/Transaction/post_api_totvsmoda_general_v2_transaction_classification_relationship_create

Obter dados de uma transação

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Transaction/get_api_totvsmoda_general_v2_transactions

Produção: https://moda.api.varejo.totvs.com.br/#/Transaction/get_api_totvsmoda_general_v2_transactions

Incluir transação

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Transaction/post_api_totvsmoda_general_v2_transactions

Produção: https://moda.api.varejo.totvs.com.br/#/Transaction/post_api_totvsmoda_general_v2_transactions

Person - PessoaDocumentação
Obter os dados de uma empresa pelo código ou CNPJ

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/get_api_totvsmoda_person_v2_branches__branchId_

Produção: https://moda.api.varejo.totvs.com.br/#/Person/get_api_totvsmoda_person_v2_branches__branchId_

Obter os dados de empresa

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/get_api_totvsmoda_person_v2_branchesList

Produção: https://moda.api.varejo.totvs.com.br/#/Person/get_api_totvsmoda_person_v2_branchesList

Relacionar cliente a representante

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/post_api_totvsmoda_person_v2_customer_representatives

Produção: https://moda.api.varejo.totvs.com.br/#/Person/post_api_totvsmoda_person_v2_customer_representatives

Criar ou alterar um cliente pessoa física

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/post_api_totvsmoda_person_v2_individual_customers

Produção: https://moda.api.varejo.totvs.com.br/#/Person/post_api_totvsmoda_person_v2_individual_customers

Obter os dados de pessoa física

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/post_api_totvsmoda_person_v2_individuals_search

Produção: https://moda.api.varejo.totvs.com.br/#/Person/post_api_totvsmoda_person_v2_individuals_search

Criar ou alterar um cliente pessoa jurídica

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/post_api_totvsmoda_person_v2_legal_customers

Produção: https://moda.api.varejo.totvs.com.br/#/Person/post_api_totvsmoda_person_v2_legal_customers

Obter os dados de pessoa jurídica

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/post_api_totvsmoda_person_v2_legal_entities_search

Produção: https://moda.api.varejo.totvs.com.br/#/Person/post_api_totvsmoda_person_v2_legal_entities_search

Consultar saldo de bônus de cliente

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/post_api_totvsmoda_person_v2_list_balance_bonus

Produção: https://moda.api.varejo.totvs.com.br/#/Person/post_api_totvsmoda_person_v2_list_balance_bonus

Obter os dados de recepção de venda

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/get_api_totvsmoda_person_v2_reception_sale_search

Produção: https://moda.api.varejo.totvs.com.br/#/Person/get_api_totvsmoda_person_v2_reception_sale_search

Obter os dados de representante

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Person/post_api_totvsmoda_person_v2_representatives_search

Produção: https://moda.api.varejo.totvs.com.br/#/Person/post_api_totvsmoda_person_v2_representatives_search

Bloco de código
titleMÉTODO
POST

...

titleDOCUMENTAÇÃO
Product - ProdutoDocumentação
Obter saldos de produtos por filtro geral

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_balances_search

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_balances_search

Incluir código de barras para produto

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_barcodes

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_barcodes

Alteração de dados de código de barras de produto

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_barcodes_update

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_barcodes_update

Obter dados de categoria

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/get_api_totvsmoda_product_v2_category

Produção: https://moda.api.varejo.totvs.com.br/#/Product/get_api_totvsmoda_product_v2_category

Incluir classificação de produto

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_classification_relationship_create

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_classification_relationship_create

Alteração de classificação de produto

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_classification_relationship_update

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_classification_relationship_update

Obter custos de produtos por filtro geral

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_costs_search

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_costs_search

Obter dados de grade

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/get_api_totvsmoda_product_v2_grid

Produção: https://moda.api.varejo.totvs.com.br/#/Product/get_api_totvsmoda_product_v2_grid

Obter dados de unidades de medida (espécie)

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/get_api_totvsmoda_product_v2_measurement_unit

Produção: https://moda.api.varejo.totvs.com.br/#/Product/get_api_totvsmoda_product_v2_measurement_unit

Obter preços de produtos por filtro geral

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_prices_search

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_prices_search

Obter lista de produtos por filtro geral

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_product_codes_search

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_product_codes_search

Obter dados de produto por filtro geral

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_products_search

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_products_search

Obter dados de produto a partir de um código

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/get_api_totvsmoda_product_v2_products__code_

Produção: https://moda.api.varejo.totvs.com.br/#/Product/get_api_totvsmoda_product_v2_products__code_

Obter dados de referências

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_references_search

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_references_search

Incluir preço ou custo de produto

Treino: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_values_create

Produção: https://moda.api.varejo.totvs.com.br/#/Product/post_api_totvsmoda_product_v2_values_create

Alterar preço ou custo de produto

Treino:

...

...

Sales-order - Pedido de vendaDocumentação
Alterar dados adicionais de um pedido de venda

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/post_api_totvsmoda_sales_order_v2_additional_order

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/post_api_totvsmoda_sales_order_v2_additional_order

Incluir um pedido de venda

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/post_api_totvsmoda_sales_order_v2_b2c_orders

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/post_api_totvsmoda_sales_order_v2_b2c_orders

Consultar sugestão de faturamento

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/get_api_totvsmoda_sales_order_v2_billing_suggestions

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/get_api_totvsmoda_sales_order_v2_billing_suggestions

Consultar tipos de desconto

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/get_api_totvsmoda_sales_order_v2_discount_type

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/get_api_totvsmoda_sales_order_v2_discount_type

Obter lista das notas fiscais vinculadas a um pedido

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/get_api_totvsmoda_sales_order_v2_invoices

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/get_api_totvsmoda_sales_order_v2_invoices

Cancelar um pedido de venda

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/post_api_totvsmoda_sales_order_v2_orders_cancel

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/post_api_totvsmoda_sales_order_v2_orders_cancel

Alterar a situação de um pedido de venda

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/post_api_totvsmoda_sales_order_v2_orders_change_status

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/post_api_totvsmoda_sales_order_v2_orders_change_status

Obter lista de pedidos de venda e seus dados por filtro geral

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/post_api_totvsmoda_sales_order_v2_orders_search

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/post_api_totvsmoda_sales_order_v2_orders_search

Gravar dados de transação TOTVS Moda PDV

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/post_api_totvsmoda_sales_order_v2_pdv_transactions

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/post_api_totvsmoda_sales_order_v2_pdv_transactions

Obter lista dos itens pendentes de um pedido

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/get_api_totvsmoda_sales_order_v2_pending_items

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/get_api_totvsmoda_sales_order_v2_pending_items

Gravar relacionamento entre contagem e pedido de venda

Treino: https://moda.api.varejo.totvs.com.br/treino/#/SalesOrder/post_api_totvsmoda_sales_order_v2_relationship_counts

Produção: https://moda.api.varejo.totvs.com.br/#/SalesOrder/post_api_totvsmoda_sales_order_v2_relationship_counts

Bloco de código
titleHEADERS
x-api-key: CHAVEUNICADEACESSO

...

defaultno
referenciaexemplo

...

HTML
<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>