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

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

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.

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

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: https://moda.api.varejo.totvs.com.br/treino/#/Product/post_api_totvsmoda_product_v2_values_update

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

Obter dados de escalas de tabela de preço

Treino: https://moda.api.varejo.totvs.com.br/treino/#/PriceTable/get_api_totvsmoda_product_v2_price_table_scales

Produção: https://moda.api.varejo.totvs.com.br/#/PriceTable/get_api_totvsmoda_product_v2_price_table_scales

Obter dados de tabela de preço

Treino: https://moda.api.varejo.totvs.com.br/treino/#/PriceTable/get_api_totvsmoda_product_v2_price_tables_headers

Produção: https://moda.api.varejo.totvs.com.br/#/PriceTable/get_api_totvsmoda_product_v2_price_tables_headers

Obter preços de produtos baseado em tabela de preço

Treino: https://moda.api.varejo.totvs.com.br/treino/#/PriceTable/post_api_totvsmoda_product_v2_price_tables_search

Produção: https://moda.api.varejo.totvs.com.br/#/PriceTable/post_api_totvsmoda_product_v2_price_tables_search

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

  • Sem rótulos