Integração ImaCash

BDP

Configura o BDP com o ImaCash por SQL Server, troca de ficheiros ou BDP Hotel. Consulta também a referência BDPCash para instalações antigas.

Logótipo de BDP Software
Hotelaria e restauração

Modalidades de integração

Escolhe a modalidade que corresponde à tua instalação. Confirma com o fornecedor o conector e os requisitos antes de alterar a configuração.

Configurar BDP por base de dados

O modo BDP utiliza SQL Server para ler documentos e pagamentos. O responsável por BDP deve confirmar a estrutura compatível e preparar uma forma específica para os pagamentos geridos pelo ImaCash.

É necessário acesso ao serviço SQL a partir do computador do ImaCash e uma conta privada com permissão de consulta dos dados necessários. Este modo usa autenticação SQL, sem DSN ODBC. Uma ligação bem-sucedida não valida toda a operação nem um modelo de máquina de numerário compatível.

Preparar a ligação

  1. Abra Configuração > Integração, escolha POS, selecione o grupo BDP e depois o modo BDP. BDP V2 e BDP V3 são nomes anteriores deste modo, não versões comerciais certificadas.
  2. Em IP do servidor, introduza o destino privado fornecido pelo administrador. Nome da BBDD corresponde à base SQL do BDP. Peça dados separados de servidor, instância e base, sem usar valores predefinidos de um guia antigo.
  3. Podem surgir dois campos com o nome Nome da BBDD. O que ocupa a posição de Instância é usado como instância na ligação. Não duplique a base nos dois campos nem repita uma instância já incluída no endereço do servidor. Se a configuração antiga for ambígua, confirme a atribuição com o administrador ou o suporte.
  4. Preencha Utilizador e Palavra-passe com a conta SQL privada fornecida pelo administrador. Esta ligação não tem campo de porta separado nem identificador de gaveta.
  5. Feche Configuração com alterações pendentes e escolha Guardar. Após validar a ligação, reveja os filtros apresentados e os diálogos Numerário e Cartão, quando aplicável. Verifique o resultado final e use Reiniciar apenas se surgir, no momento adequado e sem operações em curso.

Âmbito e verificação

A captura utiliza o valor de cada linha de pagamento aceite, preservando o sinal. Uma venda com várias formas pode gerar entradas separadas. O total da fatura não é automaticamente tratado como numerário. Para cartões, reveja também Aceitar cartões. Escolher um código não comprova um débito bancário.

Este modo SQL não marca documentos como pagos ou anulados no BDP. A confirmação física pertence ao controlador da máquina. Confirme o fluxo escolhido com o fornecedor e verifique o resultado antes de considerar a instalação validada.

BDP_Ficheros usa uma pasta de intercâmbio com permissões de leitura e escrita. BDP Hotel usa a sua própria estrutura SQL. Os requisitos e confirmações são diferentes. Não lhes atribua automaticamente o âmbito deste guia. BDPCash é um modo histórico oculto, não uma opção atual para uma nova instalação.

Formas de pagamento por base de dados

O responsável por BDP deve preparar uma forma de pagamento exclusiva para ImaCash, diferente das formas Numerário e Cartão. Use-a no POS para esses pagamentos. O numerário nativo do BDP pode registar a venda como paga sem passar pelo ImaCash. O conector não cria esta forma automaticamente.

No diálogo Numerário do ImaCash, selecione a forma preparada para ImaCash e, se aplicável, uma forma de cartão diferente. As opções vêm de FormasDePago. É apresentada a descrição e é guardado o código escolhido para a captura.

Se faltar a lista ou uma opção, confirme com o administrador a base configurada, o catálogo FormasDePago e as permissões de consulta. A ausência do diálogo não comprova uma seleção correta. Guardar sem alterações não garante reabrir a lista. Se não reaparecer, contacte o suporte.

Entradas e saídas de caixa

Os apontamentos de caixa, como compras, devem pertencer aos conceitos aceites, usar a forma de numerário selecionada e ter empregado atribuído. Devem cumprir os filtros de terminal e operador de caixa. As entradas mantêm sinal positivo e as saídas negativo. O nome de compra não basta e não deve criar-se outra venda para repetir o movimento.

Filtros de captura

Em Definições > Filtros, ative e guarde os critérios de terminal e operador necessários para esta instalação. Os terminais e empregados de mesa são selecionados dos seus catálogos. Não é descoberto um catálogo real de lojas. Os filtros delimitam a vista local de pendentes e não garantem uma leitura SQL exclusiva.

Configurar BDP por ficheiros

BDP_Ficheros troca pedidos e respostas através de uma pasta preparada pelo responsável por BDP. É um modo diferente de BDP SQL e BDP Hotel.

O fornecedor deve ativar um intercâmbio compatível. As contas que executam BDP e ImaCash precisam de acesso à mesma pasta e de permissões para ler, criar, escrever e gerir os ficheiros do intercâmbio. Use uma pasta dedicada, sem documentos, cópias de segurança ou dados alheios.

Preparar a ligação

  1. Abra Configuração > Integração, escolha POS, selecione o grupo BDP e depois BDP_Ficheros.
  2. Em Vendas, use o seletor de pasta para escolher o caminho de intercâmbio confirmado pelo responsável por BDP. Este campo recebe uma pasta, não um ficheiro específico. Uma pasta existente ou vazia não comprova que BDP esteja a enviar pedidos.
  3. Reveja com o fornecedor a opção «Versão do BDP igual ou superior a 35.1.». Ajuste-a ao intercâmbio instalado: altera a publicação da resposta. O rótulo não comprova uma versão mínima universal nem compatibilidade comercial.
  4. Feche Configuração com alterações pendentes e escolha Guardar. Verifique o resultado e use Reiniciar apenas se for apresentado, no momento adequado e sem operações em curso. Guardar não substitui a verificação de permissões e do intercâmbio completo.
  5. Antes do uso real, combine um teste supervisionado: verificar pedido recebido, referência e valor com cêntimos, resultado físico e resposta reconhecida por BDP. Se faltar algum elemento, a instalação continua por validar.

Pedidos, respostas e filtros

A ligação utiliza referência, valor, data, terminal e empregado da mensagem. Trata o pedido normal como numerário. Não apresenta o catálogo SQL de formas de pagamento nem valida, por si só, cartões ou pagamentos mistos.

A resposta comunica o resultado por referência, incluindo cancelamento e valores entregues e devolvidos, quando aplicável. Verifique que BDP a recebe e interpreta. Um pedido ou ficheiro de cancelamento não comprova que a máquina parou ou devolveu o numerário. Perante um resultado pendente ou incerto, reveja ambos os sistemas e o numerário real antes de repetir, reiniciar ou cobrar novamente.

Em Definições > Filtros, reveja os critérios locais da instalação perante os identificadores de terminal e empregado recebidos. Este modo não descobre catálogos SQL de terminais, empregados ou lojas.

Não configure servidor SQL, utilizador, palavra-passe ou DSN neste modo. O intercâmbio não importa produtos nem turnos. A existência de ficheiros ou um estado de ligação correto não valida a operação física nem a conclusão correta em BDP.

Não aplique a este guia formas de pagamento, apontamentos de caixa ou confirmações de BDP SQL, Hotel ou outros circuitos. O fornecedor deve confirmar o modo, a versão instalada e o fluxo concreto.

A imagem seguinte é uma captura histórica em espanhol, com o campo Vendas vazio. Mostra Hospitality e um botão Guardar antigos; o percurso atual é POS > BDP > BDP_Ficheros e a gravação confirma-se ao fechar Configuração.

Configurar BDP Hotel

BDP Hotel utiliza a sua própria estrutura SQL Server. O responsável por BDP deve confirmar o modo instalado, a estrutura compatível e as formas de pagamento antes de preparar a ligação ao ImaCash.

O computador e a conta que executam ImaCash precisam de acesso ao serviço SQL e de uma conta SQL privada com permissão de consulta de faturas, formas de pagamento, caixas e empregados. Este modo não usa uma pasta de intercâmbio nem um DSN ODBC.

Preparar a ligação

  1. Abra Configuração > Integração, escolha POS, selecione o grupo BDP e depois BDP Hotel.
  2. Em IP do servidor, introduza o destino privado fornecido pelo administrador, separado do nome de instância. Este modo constrói o destino a partir dos dois campos; não repita a instância no servidor.
  3. Em Nome da BBDD, introduza a base Hotel confirmada pelo administrador. Em Nome da instância, indique a instância SQL correspondente. Não reutilize dados do BDP normal só por partilhar a marca nem suponha valores predefinidos.
  4. Preencha Utilizador e Palavra-passe com a conta SQL privada autorizada. Este modo não tem campo de porta separado nem seletor de autenticação Windows.
  5. Feche Configuração com alterações pendentes e escolha Guardar. Após validar a ligação, reveja os filtros e os diálogos Numerário e Cartão quando apresentados. Verifique o resultado final; use Reiniciar apenas se surgir, no momento adequado e sem operações em curso.

Pagamentos, faturas e limites

O catálogo de pagamentos Hotel é Formas_DePago, distinto de FormasDePago do BDP normal. O diálogo apresenta a descrição e guarda o código escolhido. Selecione a forma real de numerário e, quando aplicável, outra diferente de cartão; reveja também Aceitar cartões. Escolher um código não comprova um débito bancário.

Se faltar a lista ou uma forma, reveja com o administrador o catálogo Hotel e as permissões de consulta. A ausência do diálogo não valida uma escolha anterior. Guardar sem alterações não garante voltar a ler as opções; contacte o suporte se não reaparecerem.

A leitura percorre até cinco posições de pagamento positivas da fatura e para na primeira sem valor positivo. Utiliza a caixa de cada pagamento e o empregado da fatura. Conserva a data da fatura, não a hora original do recebimento. Verifique faturas com várias formas: não se garante qualquer esquema misto nem o tratamento de formas não configuradas.

Em Definições > Filtros, reveja as caixas de pagamento e os empregados recebidos perante os critérios locais ativos. Confirme as correspondências entre nomes e códigos com o responsável por BDP. Este modo não descobre um catálogo real de lojas e ativar filtros não garante uma leitura SQL exclusiva.

Não atribua a Hotel os apontamentos de caixa, compras ou devoluções negativas do BDP normal. O conector não importa produtos nem turnos e não marca faturas como pagas ou anuladas em BDP. Um aviso local ou uma ligação correta não valida esses resultados nem a operação física da máquina.

Antes do uso real, combine um teste supervisionado de referência, código de pagamento, valor com cêntimos, caixa, empregado e filtros; inclua cartão e várias formas quando aplicável. Perante um resultado incerto, verifique ambos os sistemas e o numerário real antes de repetir ou reiniciar. O fornecedor deve confirmar o fluxo instalado.

BDP SQL e BDP_Ficheros são modos diferentes, com requisitos e confirmações próprios. Este guia Hotel não certifica modelos, firmware ou versões comerciais compatíveis.

BDPCash: referência para instalações antigas

BDPCash é um modo histórico que não está disponível no seletor atual do ImaCash para novas configurações. Esta página conserva a referência de instalações anteriores.

Não é outro nome de BDP por SQL Server, BDP Hotel ou BDP_Ficheros. As antigas designações Cash/Lean não identificam um modo atual nem comprovam compatibilidade com uma versão do fornecedor.

Se já utiliza BDPCash

  1. Confirme com o responsável de BDP e o suporte do ImaCash o modo utilizado pela instalação e a configuração que deve conservar.
  2. Não substitua BDPCash por BDP, BDP Hotel ou BDP_Ficheros apenas pela semelhança dos nomes, nem copie os dados de um guia antigo.
  3. Antes de alterar, acorde os requisitos, os meios de pagamento e os filtros, e valide o circuito completo num teste supervisionado. Uma ligação não comprova uma cobrança nem compatibilidade física.

Os dados do servidor, base, instância e conta, quando necessários, são privados e fornecidos pelo administrador.

Guias dos modos atuais

Estes guias descrevem modos diferentes. Confirme com o fornecedor qual corresponde à instalação; não convertem automaticamente uma instalação BDPCash.

BDP

Rever a integração BDP

Confirme modo, estrutura, formas de pagamento e filtros com o responsável por BDP antes de planear a validação da instalação.