Importação automática dos seus dados → pela nossa API web

Ajuda online

Automatic import »
How to import your data automatically?

Translate this page to

Carregando...

Para tirar proveito desta interface, use um script que enviará todas as noites ou várias vezes por dia (por exemplo) os seus arquivos de faturas, clientes, usuários (opcional) e contatos (opcional) para o nosso servidor.

Este programa deverá enviar arquivos CSV ou TXT (arquivo separado por ponto e vírgula nos dados do POST) utilizados os IDs, endereços e sintaxes abaixo:

Conecte-se à sua conta pelo nosso API

Para se conectar, utilize esta ID e esta senha:

Endereço / URL:

https://account.mydsomanager.com/api/

Você deve estar conectado para ver essas informações

Exemplo « Headers »

POST ...
...
Authorization: Você deve estar conectado para ver essas informações
...

Opções de importação

Use essas opções somente se precisar:

Configurações	API	Descrição
encoding	all	Formato do arquivo Valores possíveis: UTF-8 (predefinido), ISO-8859-1, ...
clear_items_not_modified	items	Saldar os itens automaticamente? Valores possíveis: true:Modo « STOCK » → Eu importo sistematicamente todas as peças não saldadas (faturas, notas de crédito, operações diversas... ainda não letradas e saldadas). Neste caso, se uma fatura está presente numa importação e não está mais na seguinte, o MY DSO MANAGER a saldará automaticamente. false:Modo « DELTA » → Eu importo todas as novas peças (faturas, notas de crédito, operações diversas.. ainda não letradas e saldadas) emitidas desde a última importação, bem como todas as que foram saldadas. Estas últimas contêm o campo 'item_date_payment' preenchido com a data na qual o item foi saldado no sistema contábil. Isso permitirá que o MY DSO MANAGER as salde também. Predefinido: false
replace_users_association	users	Substituir associações clientes/usuários ou adicionar somente as novas associações clientes/usuários? Valores possíveis: 0 ou 1 Predefinido: 0

Exemplo « Headers » e « Data »

POST /api/items?encoding=UTF-8&clear_items_not_modified=true HTTP/1.1
...

data...

Adicione e edite os seus itens (faturas, notas de crédito...)

Endereço / URL: https://account.mydsomanager.com/api/items

Utilizar o SSL para proteger as suas conexões

Sintaxe das colunas do arquivo CSV:

Colunas	Descrição
client_code *	Código do cliente
item_amount_initial	Valor inicial sem IVA
item_amount_initial_inc_tax *	Valor inicial com IVA Exemplo / Valores possíveis: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Valor restante sem IVA
item_amount_remaining_inc_tax	Valor restante com IVA
item_business_case	Business case
item_currency	Divisa Exemplo: EUR, USD, ...
item_date_due *	Data de vencimento Formato da data: YYYY-MM-DD
item_date_issue *	Data de emissão Formato da data: YYYY-MM-DD
item_date_order	Data do pedido Formato da data: YYYY-MM-DD
item_date_payment	Data de pagamento Formato da data: YYYY-MM-DD
item_erp_type	Tipo de item ERP
item_file_number	Número do dossiê
item_number *	Número de documento
item_order_number	Número do pedido
item_sales_administrative	Administrativo de vendas
item_sales_manager	Gerente de vendas
item_type *	Tipo de item Valores possíveis: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key	Identificador único do item

Exemplo « Headers » e « Data »

POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Você deve estar conectado para ver essas informações
...

"item_type";"item_number";"client_code";"item_date_issue";"item_date_issue";"item_amount_initial_inc_tax";"item_currency"
"FAC";"00000123";"C0001";"2026-03-14";"2026-03-21";"6 580,10";"USD"
...

Colunas obrigatórias : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Adicione e edite os seus clientes

Endereço / URL: https://account.mydsomanager.com/api/clients

Utilizar o SSL para proteger as suas conexões

Sintaxe das colunas do arquivo CSV:

Colunas	Descrição
client_address_city	Endereço (Cidade)
client_address_country	Endereço (País)
client_address_postbox	Endereço (Caixa postal)
client_address_state	Endereço (Estado / Província)
client_address_street	Endereço (Rua)
client_address_street_line2	Endereço (Rua Linha 2)
client_address_street_line3	Endereço (Rua Linha 3)
client_address_street_number	Endereço (n° Rua)
client_address_zip	Endereço (Código postal)
client_blocked	Conta bloqueada (Sim / Não) Valores possíveis: 0, 1 (predefinido: 0 <=> Não)
client_blocked_date	Conta bloqueada / Data Formato da data: YYYY-MM-DD
client_business_line	Área de negócio
client_business_name *	Razão social
client_code *	Código do cliente
client_comments	Comentários
client_commercial_email	Gerente de vendas associado ao cliente / E-mail
client_commercial_fax	Gerente de vendas associado ao cliente / Fax
client_commercial_firstname	Gerente de vendas associado ao cliente / Nome
client_commercial_lastname	Gerente de vendas associado ao cliente / Sobrenome
client_commercial_matricule	Gerente de vendas associado ao cliente / Matrícula
client_commercial_phone	Gerente de vendas associado ao cliente / Telefone
client_commercial_phone_cell	Gerente de vendas associado ao cliente / Celular
client_credit_limit	Risco / Limite de crédito
client_email	E-mail
client_fax	Fax
client_group	Grupos Lista de grupos de clientee separados por vírgulas
client_guarantee_insurer	Risco / Garantia seguradora
client_guarantee_insurer_reference	Risco / Referência da seguradora
client_guarantee_score	Risco / Score
client_guarantee_temporary	Risco / Garantia temporária
client_guarantee_temporary_date_end	Risco / Garantia temporária / Data final
client_guarantee_temporary_date_start	Risco / Garantia temporária / Data de início
client_guarantee_type	Risco / Tipo de garantia
client_guarantees_currency	Risco / Divisa das garantias
client_id	Identificação fiscal
client_order_backlog	Carteira de pedidos
client_others_guarantees	Risco / Outras garantias
client_payment_mean	Meio de pagamento
client_payment_term	Prazo para pagamento
client_phone	Telefone
client_phone_cell	Celular
client_siret	Siret (para empresas francesas)
client_trading_name	Nome comercial
client_unique_key	Identificador único de cliente
client_url	Site web
client_vat	Número de IVA

Exemplo « Headers » e « Data »

POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Você deve estar conectado para ver essas informações
...

"client_business_name";"client_code";"client_id";"client_address_country"
"My company";"C0001";"FR12345678";"France"
...

Colunas obrigatórias : client_code + client_business_name

Adicione contatos aos seus clientes

Endereço / URL: https://account.mydsomanager.com/api/contacts

Utilizar o SSL para proteger as suas conexões

Sintaxe das colunas do arquivo CSV:

Colunas	Descrição
client_code *	Código do cliente
contact_collection	Contato para cobrança (Sim / Não) Valores possíveis: 0, 1 (predefinido: 0 <=> Não)
contact_comments	Comentários
contact_email	E-mail
contact_email_copy_collection_auto	E-mail em cópia nos e-mails automáticos (Sim / Não) Valores possíveis: 0, 1 (predefinido: 0 <=> Não)
contact_fax	Fax
contact_firstname	Nome
contact_lastname *	Sobrenome
contact_phone	Telefone
contact_phone_cell	Celular
contact_role	Função Valores possíveis: accounting: Contador buyer: Cliente company: Empresa manager: Diretor executivo other: Outro (predefinido)
contact_title	Título (Sr, Sra ...)
contact_unique_key	Identificador único de contato

Exemplo « Headers » e « Data »

POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Você deve estar conectado para ver essas informações
...

"contact_firstname";"contact_lastname";"contact_role";"client_code"
"Mike";"Jackson";"other";"C0001"
...

Colunas obrigatórias : client_code + contact_lastname

Associe usuários aos seus clientes

Endereço / URL: https://account.mydsomanager.com/api/users

Utilizar o SSL para proteger as suas conexões

Sintaxe das colunas do arquivo CSV:

Colunas	Descrição
client_code *	Código do cliente
user_email	E-mail
user_firstname	Nome
user_lastname *	Sobrenome
user_matricule	Matrícula

Exemplo « Headers » e « Data »

POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Você deve estar conectado para ver essas informações
...

"user_firstname";"user_lastname";"client_code"
"John";"Roy";"C0001"
...

Colunas obrigatórias : client_code + user_lastname

If you want, you can use the path "/apiPutFiles/" to import the files asynchronously.

Dados de retorno

Após realizar o POST desses dados, o MY DSO MANAGER processará imediatamente e responderá informando se houve algum erro ou quantos dados foram adicionados e atualizados.

Essa resposta será em formato JSON e retornará as seguintes informações:

Campo	Descrição
success	Indica se a importação foi bem sucedida Valores possíveis: true, false
error_code	Código de erro (se houver erro) Valores possíveis: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Mensagem de erro (se houver erro)
exception_lines	Linhas ignoradas (não definido se não houver linhas ignoradas)
nb_client_added	Clientes adicionados
nb_client_modified	Clientes modificados
nb_contact_added	Contatos adicionados
nb_item_added	Itens adicionados
nb_item_modified	Itens modificados
nb_user_added	Usuários adicionados
nb_user_modified	Usuários atualizados

Exemplo « Response »

{
	"success": "true",
	"nb_client_added": 0,
	"nb_client_modified": 0,
	"nb_contact_added": 0,
	"nb_item_added": 5,
	"nb_item_modified": 2,
	"nb_user_added": 0,
	"nb_user_modified": 0,
	"exception_lines": {
		"line 3": "Column count doesn't match (defined=8, found=10)",
	},
}

Importe seus dados automaticamente por FTP ou SFTP!

Este programa deverá enviar arquivos CSV ou TXT (arquivo separado por ponto e vírgula nos dados do POST) utilizados os IDs, endereços e sintaxes abaixo:

How FTPs and SFTP works with My DSO Manager

Compatível com diversos softwares: SAP

...

Conecte-se à sua conta via FTP seguro ou entre em contato conosco para utilizar SFTP

Para se conectar, utilize esta ID e esta senha:

Implementação:

Utilize os mesmos arquivos CSV que usou durante a importação manual « Smart Upload »
Nomeio-os de modo que o MY DSO MANAGER saiba qual é o tipo de arquivo enviado
(arquivos de clientes devem começar com "clientes", arquivos de fatura com "faturas" e arquivos de contatos com "contatos")
Envie estes arquivos
Os dados são instantaneamente processados e atualizados na sua conta. O arquivo que acaba de enviar é substituído por um arquivo de relatório que indica se tudo correu bem e quantas modificações foram feitas.

Pré-visualização utilizando o software FileZilla para transferir os seus arquivos:

Esta pré-visualização mostra uma importação manual, mas você pode torná-la automática criando um script que envia arquivos CSV.

Como automatizar o envio por FTP seguro:

Enviar por curl (Windows, Linux):

curl -u login:password ftp://ftp.mydsomanager.com:21 --ftp-ssl --ftp-pasv -T clients.csv

Enviar por LFTP (Linux, Windows via cygwin):

lftp -e "set ftp:prefer-epsv no; put clients.csv; quit" -u login,password ftp.mydsomanager.com

Enviar por WinSCP (Windows):

winscp.com /ini=nul /command "open ftpes://login:password@ftp.mydsomanager.com/" "put clients.csv" "exit"

Com os nossos conectores, é possível importar os seus dados de cliente e de contabilidade (faturas, notas de crédito,...) de forma simples e automática!

Para isso, selecione o seu software de gestão e siga as instruções abaixo para sincronizar os seus dados com o My DSO Manager com a frequência desejada (diariamente, semanalmente ou manualmente).