CTA SMART - Importação de Abastecimentos
Nome da Integração ou customização:
CTA SMART - Importação de abastecimentos / Saídas de Estoque
Finalidade:
Buscar abastecimentos de veículos/máquinas fornecidos via API pela CTA, fazendo assim a geração das saídas de estoque de forma automática, bem como a geração do contas a pagar, após isso devolver a abastecida a mesma API para fins de sincronização.
Funcionamento:
1: A cada 5 minutos buscamos as abastecidas disponibilizadas de X últimos dias (definidos em configuração via painel)
2: Todas as abastecidas retornadas que possuírem o campo "posto-comercial"== false serão inseridas como saída de estoque no Movtrans, após isso a geração de Contas Pagar da Saída.
3: Após esse processo, é enviado o ID da Abastecida para a CTA, a fim de sincronizar a mesma para que não seja retornada novamente na próxima consulta.
4. O ID da abastecida ficara disponível nas Observações da SAÍDA para consulta.
Critérios para uso:
O usuário precisa fazer a relação de Produto (id do combustível na API) com o Local de Estoque (id da bomba na API).
Os veículos e motoristas devem ser cadastrados em ambos: Movtrans > CTA, o código de cada um fará essa ligação.
O Movtrans precisa possuir um usuário cadastrado com o nome "CTA SMART" para geração dos registros.
O usuário também pode fazer a ligação entre CTA e Movtrans para utilizar plano de contas e centro de custos específicos através de campos extras (Consultar configuração abaixo).
Configuração:
Necessário configurar no Movtrans nas configurações de empresa: Token CTA, Centro de Custos padrão, Plano de Contas padrão e veículo padrão(Configurar os códigos, para fins de utilizar como padrão para quando a API não obtém essa informação do retorno da CTA).
Ligação de campos Movtrans x CTA:
Plano de Contas ID x Campo Extra > código
Centro de Custos ID x Campo Extra > código
Veículo ID x Veículo > código
Motorista ID x Motorista > Código
Produto (Código Integração) X Combustível > código
Local de Estoque (Id Integração) X Posto > ID
Lembrando que os dois últimos itens precisam ter ligação entre si através da ligação Produto / Estoque no Movtrans.
Configurações necessárias serem feitas no painel no momento pelo Desenvolvimento até que seja adaptado no painel Movtrans:
> Configurar as URL's de ambos os endpoints CTa
> Os íltimos dias para buscar os registros na API
> Ligação de campos extras na API CTA com o campo que o cliente deseja utilizar para popular no Movtrans. Ex: Cliente X quer que o campo extra 4 irá trazer o código que irá popular o código do Centro de Custo. (Até o momento só é possível ligar campos extras aos seguintes campos no sistema: Plano de Contas, Centro de Custos e Observações)
Consulta de Logs:
1. Acessar um dos servidores de produção (44, 45 ou 55);
2. No navegador, utilize a URL base: [http://192.168.1.233:7014/api/cta_smart/] ;
3. Para indicar qual dos logs deseja acessar, informe o parâmetro de tipo "t" (error = excessões geral | sinc = sicronia), como no exemplo: [http://192.168.1.233:7014/api/cta_smart/?t=error] ;
4. Para indicar qual a data dos logs deseja acessar, informe o parâmetro de data "d", utilizando o formato ANO-MÊS-DIA (AAAA-MM-DD), como no exemplo: [http://192.168.1.233:7014/api/cta_smart/?t=error&d=2024-11-01] ;
*OBS: No momento, só pode ser acessado à partir de nossos servidores (44, 45 e 55)*
Principais Rejeições: "Erro" - Resolutiva:
CTA SMART : produto id: X e bomba id: X não encontrado no estoque da abastecida ID: X: A abastecida na CTA possui um id de combústivel e posto que ainda não tem ligação no Produto x Estoque do Movtrans.
CTA SMART : Veículo X ou Motorista X não encontrado: Indica que o código de algum não bateu com o código Movtrans, não interfere no funcionamento pois caso não encontre será utilizado o padrão configurado.
CTA SMART : Usuário CTA SMART não configurado : Campo obrigatório no banco de Dados, necessário configurar um usuário de nome CTA SMART
CTA SMART: Abastecida não sincronizada: Possivelmente já foi sincronizada anteriormente.
CTA SMART: Configurações de empresa não encontradas: Integração não configurado no Movtrans para a empresa.