Estamos constantemente desenvolvendo novas integrações para ajudar você a criar um ecossistema de ferramentas de negócios e automatizar ao máximo os processos rotineiros. Com esse objetivo, introduzimos várias melhorias na API Pública, permitindo que você integre o Orderry a serviços de terceiros por conta própria. Hoje, estamos empolgados em apresentar novos métodos de API e atualizações para os existentes.
Leads
O método para obter uma lista de leads agora suporta os seguintes parâmetros de consulta:
modified_at – filtrar pela data em que os leads foram atualizados.
closed_at – filtrar pela data em que os leads foram encerrados.
Além disso, a resposta agora inclui detalhes completos para cada lead:
created_at – a data em que o lead foi criado.
modified_at – a data em que o lead foi atualizado.
closed_at – a data em que o lead foi encerrado.
rel_obj – o objeto associado ao lead (ordem, venda).
Criar Ordem
O método para criar ordens agora suporta o parâmetro opcional asset_id.
Obter Ordens
O método para obter uma lista de ordens agora retorna um objeto uom (unidade de medida) para produtos e serviços, que inclui:
id – o ID da unidade de medida.
title – o nome curto.
description – o nome completo.
Novo Método: Obter Ordem por ID
Com este método, você pode obter dados de uma ordem específica usando seu ID.
O método para obter uma lista de vendas agora suporta o parâmetro de consulta created_at, permitindo filtrar pela data de criação da venda. Ele também retorna um objeto uom para produtos e serviços, com detalhes como id, title e description.
Novo Método: Criar Pagamento
Este método permite automatizar a criação de pagamentos no Orderry quando os pagamentos são feitos em outros serviços.
Novo Método: Obter Itens de Fluxo de Caixa
Se você usa itens de fluxo de caixa, agora pode obter sua lista com este método.
Obter Transações em Dinheiro
O método para obter transações em dinheiro agora inclui o parâmetro cashflow_item (o nome e tipo do item de fluxo de caixa: receita ou despesa). Além disso, retorna client_id (o ID do cliente, se especificado no pagamento) e related_document (o documento relacionado ao pagamento, como uma ordem, venda ou reembolso).
O método para obter uma lista de faturas da empresa agora inclui os parâmetros code (código do produto) e article (SKU do produto).
Se você trabalha com ativos (como dispositivos, veículos, etc.) em outros sistemas, preparamos um conjunto de novos métodos da API Pública para este propósito.
Obter Ativos
Use este método para obter uma lista de ativos na sua conta junto com todos os detalhes, incluindo ID, número de série/VIN/IMEI, dados do grupo, marca, modelo, proprietário e mais.
Obter Ativo por ID
Use este método para obter dados de um ativo específico usando seu ID.
Obter Campos Personalizados do Ativo
Este método permite obter uma lista de campos personalizados para ativos na página "Configurações > Editor de Formulários > Ativos".
Criar Ativo
Use este método para criar novos ativos na sua conta. Certifique-se de preencher todos os campos obrigatórios (marcados na página "Configurações > Editor de Formulários > Ativos").
Atualizar Ativo
Este método permite atualizar detalhes do ativo, como número de série, proprietário, grupo, marca, modelo e outros campos.
Mover Ativo
Use este método para transferir ativos para outros armazéns.
Obter Valores do Diretório de Ativos
Este método recupera todos os elementos do diretório hierárquico Grupo-Marca-Modelo-Modificação para ativos, junto com seus IDs.
Adicionamos novos métodos e melhoramos os existentes para trabalhar com clientes, incluindo correções na funcionalidade de campos personalizados.
Novo Método: Obter Cliente por ID
Este método permite obter todos os dados disponíveis de um cliente específico usando seu ID.
Novo Método: Mesclar Clientes
Use este método para mesclar clientes duplicados especificando todos os IDs duplicados e o ID do cliente em que eles serão consolidados.
Criar Cliente e Atualizar Cliente
Estes métodos agora suportam os parâmetros de consulta first_name e last_name, permitindo criar e atualizar clientes com mais precisão.
Obter Clientes
Este método agora suporta o parâmetro ids[], permitindo obter dados de clientes específicos por seus IDs.
Preparamos quatro métodos totalmente novos para trabalhar com o catálogo de produtos da sua empresa.
Obter Produtos
Use este método para obter uma lista dos produtos da sua empresa na página "Minha Empresa > Produtos".
Obter Produto por ID
Use este método para obter detalhes de um produto específico pelo seu ID.
Criar Produto
Este método permite adicionar novos produtos ao seu catálogo. Observe que ele não define os níveis de estoque do produto; apenas cria o perfil do produto na página "Minha Empresa > Produtos".
Atualizar Produto
Use este método para atualizar detalhes do produto, como categoria, nome, descrição, preços e mais.
Para os serviços, também estamos introduzindo quatro novos métodos.
Obter Categorias de Serviços
Este método permite obter uma lista das categorias de serviços da sua empresa com seus nomes e IDs, que podem ser usados para criar ou atualizar serviços.
Obter Serviços
Use este método para obter uma lista de serviços, incluindo suas categorias, unidades de medida, detalhes de garantia, preços e mais.
Criar Serviço
Este método permite criar novos serviços na sua conta.
Atualizar Serviço
Use este método para atualizar detalhes dos serviços da sua empresa, como nomes, preços, categorias, unidades de medida e mais.
Próximas Melhorias na API Pública do Orderry
Estamos trabalhando em novos métodos da API que permitirão gerenciar orçamentos, adicionar serviços e produtos às ordens com ou sem dedução de estoque, e configurar integrações com lojas online e marketplaces.
Em breve, você também poderá usar a API para criar, editar, fechar e recuperar tarefas.
Se você tiver dúvidas, sugestões ou comentários sobre a API Pública do Orderry, entre em contato com nossa equipe de suporte pelo chat.