Importe automáticamente sus datos → mediante nuestra API web

Ayuda en línea

Automatic import »
How to import your data automatically?

Translate this page to

Cargando...

Para beneficiarse de esta interfaz, utilice un script que enviará cada noche (por ejemplo) o varias veces al día sus archivos de documentos, clientes, usuarios (opcional) y contactos (opcional) a nuestro servidor.

Este programa deberá enviar archivos CSV o TXT (archivo separado por puntos y coma en los datos POST) utilizando los identificadores, direcciones y sintaxis indicados a continuación:

Conexión a su cuenta a través de nuestra API

Para iniciar sesión, utilice este nombre de usuario y esta contraseña:

Dirección / URL:

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

Debe iniciar sesión para ver esta información

Ejemplo « Headers »

POST ...
...
Authorization: Debe iniciar sesión para ver esta información
...

Opciones de importación

Utilice estas opciones únicamente si las necesita:

Parámetro	API	Descripción
encoding	all	Formato del archivo Valores posibles: UTF-8 (por defecto), ISO-8859-1, ...
clear_items_not_modified	items	Saldar automáticamente los documentos? Valores posibles: true:Modo « STOCK » → Importo sistemáticamente todos los documentos no saldados (facturas, abonos, operaciones diversas... aún no conciliadas ni saldadas). En este caso, si un documento está presente durante una importación y ya no lo está en la siguiente, MY DSO MANAGER la saldará automáticamente. false:Modo « DELTA » → Importo todos los nuevos documentos (facturas, abonos, operaciones diversas... aún no conciliadas ni saldadas) emitidos desde la última importación, así como todos los que se han saldado. Estos últimos tienen el campo «item_date_payment» rellenado con la fecha en la que se saldó cada documento en el sistema contable. Esto permitirá que MY DSO MANAGER también las salde. Por defecto: false
replace_users_association	users	Sustituir las asociaciones clientes/usuarios o añadir solo las nuevas asociaciones clientes/usuarios? Valores posibles: 0 o 1 Por defecto: 0

Ejemplo « Headers » y « Data »

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

data...

Añada y modifique sus documentos (facturas, abonos...)

Dirección / URL: https://account.mydsomanager.com/api/items

Utilizar el SSL para proteger sus sesiones

Sintaxis de las columnas del archivo CSV:

Columnas	Descripción
client_code *	Código de cliente
item_amount_initial	Importe inicial sin IVA
item_amount_initial_inc_tax *	Importe inicial con IVA Ejemplo / Valores posibles: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Importe restante sin IVA
item_amount_remaining_inc_tax	Importe restante con IVA
item_business_case	Nombre del asunto
item_currency	Divisa Ejemplo: EUR, USD, ...
item_date_due *	Fecha de vencimiento Formato de fecha: YYYY-MM-DD
item_date_issue *	Fecha de emisión Formato de fecha: YYYY-MM-DD
item_date_order	Fecha de pedido Formato de fecha: YYYY-MM-DD
item_date_payment	Fecha de pago Formato de fecha: YYYY-MM-DD
item_erp_type	Tipo de documento ERP
item_file_number	N.º de expediente
item_number *	N.º de documento
item_order_number	N.º de pedido
item_sales_administrative	Administrativo de ventas
item_sales_manager	Comercial
item_type *	Tipo de documento Valores posibles: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key	Identificador de documento único

Ejemplo « Headers » y « Data »

POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Debe iniciar sesión para ver esta información
...

"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"
...

Columnas obligatorias : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Añada y modifique sus clientes

Dirección / URL: https://account.mydsomanager.com/api/clients

Utilizar el SSL para proteger sus sesiones

Sintaxis de las columnas del archivo CSV:

Columnas	Descripción
client_address_city	Dirección (Ciudad)
client_address_country	Dirección (País)
client_address_postbox	Dirección (Apartado de correos)
client_address_state	Dirección (Estado / Provincia)
client_address_street	Dirección (Calle)
client_address_street_line2	Dirección (Calle Línea 2)
client_address_street_line3	Dirección (Calle Línea 3)
client_address_street_number	Dirección (n° Calle)
client_address_zip	Dirección (Código postal)
client_blocked	Cuenta bloqueada (Sí / No) Valores posibles: 0, 1 (por defecto: 0 <=> No)
client_blocked_date	Cuenta bloqueada / Fecha Formato de fecha: YYYY-MM-DD
client_business_line	Línea de negocio
client_business_name *	Razón social
client_code *	Código de cliente
client_comments	Comentarios
client_commercial_email	Comercial asociado al cliente / Correo electrónico
client_commercial_fax	Comercial asociado al cliente / Fax
client_commercial_firstname	Comercial asociado al cliente / Nombre
client_commercial_lastname	Comercial asociado al cliente / Apellidos
client_commercial_matricule	Comercial asociado al cliente / Número de identificación
client_commercial_phone	Comercial asociado al cliente / Teléfono
client_commercial_phone_cell	Comercial asociado al cliente / Teléfono móvil
client_credit_limit	Riesgo / Límite de crédito
client_email	Correo electrónico
client_fax	Fax
client_group	Grupos Lista de los grupos del cliente separada por comas
client_guarantee_insurer	Riesgo / Garantía asegurador
client_guarantee_insurer_reference	Riesgo / Referencia asegurador
client_guarantee_score	Riesgo / Calificación
client_guarantee_temporary	Riesgo / Garantía temporal
client_guarantee_temporary_date_end	Riesgo / Garantía temporal / Fecha de finalización
client_guarantee_temporary_date_start	Riesgo / Garantía temporal / Fecha de inicio
client_guarantee_type	Riesgo / Tipo de garantía
client_guarantees_currency	Riesgo / Divisa de las garantias
client_id	Identificador legal
client_order_backlog	Portafolio de pedidos
client_others_guarantees	Riesgo / Otras Garantías
client_payment_mean	Medio de pago
client_payment_term	Plazo de pago
client_phone	Teléfono
client_phone_cell	Teléfono móvil
client_siret	Siret (para las empresas francesas)
client_trading_name	Nombre Comercial
client_unique_key	Identificador de cliente único
client_url	Sitio web
client_vat	Número de IVA

Ejemplo « Headers » y « Data »

POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Debe iniciar sesión para ver esta información
...

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

Columnas obligatorias : client_code + client_business_name

Añada contactos a sus clientes

Dirección / URL: https://account.mydsomanager.com/api/contacts

Utilizar el SSL para proteger sus sesiones

Sintaxis de las columnas del archivo CSV:

Columnas	Descripción
client_code *	Código de cliente
contact_collection	Contacto para la gestión de cobros (Sí / No) Valores posibles: 0, 1 (por defecto: 0 <=> No)
contact_comments	Comentarios
contact_email	Correo electrónico
contact_email_copy_collection_auto	Correo electrónico en copia en los correos electrónicos automáticos (Sí / No) Valores posibles: 0, 1 (por defecto: 0 <=> No)
contact_fax	Fax
contact_firstname	Nombre
contact_lastname *	Apellidos
contact_phone	Teléfono
contact_phone_cell	Teléfono móvil
contact_role	Cargo Valores posibles: accounting: Contable buyer: Comprador company: Empresa manager: Directivo other: Otro (por defecto)
contact_title	Título (Sr, Sra...)
contact_unique_key	Identificador de contacto único

Ejemplo « Headers » y « Data »

POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Debe iniciar sesión para ver esta información
...

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

Columnas obligatorias : client_code + contact_lastname

Asociar los usuarios a sus clientes

Dirección / URL: https://account.mydsomanager.com/api/users

Utilizar el SSL para proteger sus sesiones

Sintaxis de las columnas del archivo CSV:

Columnas	Descripción
client_code *	Código de cliente
user_email	Correo electrónico
user_firstname	Nombre
user_lastname *	Apellidos
user_matricule	Número de identificación

Ejemplo « Headers » y « Data »

POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Debe iniciar sesión para ver esta información
...

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

Columnas obligatorias : client_code + user_lastname

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

Datos devueltos

Tras haber efectuado el POST de estos datos, MY DSO MANAGER los procesará inmediatamente y nos responderá si ha habido algún error o cuántos datos se han añadido o modificado.

Esta respuesta estará en formato JSON y devolverá la siguiente información:

Campo	Descripción
success	Indica si la importación se ha realizado correctamente Valores posibles: true, false
error_code	Código de error (si se produjo un error) Valores posibles: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Mensaje de error (si se produjo un error)
exception_lines	Líneas que se ignoraron (no definido si no se ignoró ninguna línea)
nb_client_added	Clientes añadidos
nb_client_modified	Clientes modificados
nb_contact_added	Contactos añadidos
nb_item_added	Documentos añadidos
nb_item_modified	Documentos modificados
nb_user_added	Usuarios añadidos
nb_user_modified	Usuarios modificados

Ejemplo « 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 sus datos de manera automática vía FTP o SFTP!

Este programa deberá enviar archivos CSV o TXT (archivo separado por puntos y coma en los datos POST) utilizando los identificadores, direcciones y sintaxis indicados a continuación:

How FTPs and SFTP works with My DSO Manager

Compatible con multitud de softwares: SAP

...

Conexión a su cuenta mediante FTP seguro o contáctenos para utilizar SFTP

Para iniciar sesión, utilice este nombre de usuario y esta contraseña:

Configuración:

Utilice los mismos archivos CSV que usó durante la importación manual « Smart Upload »
Nómbrelos de tal forma que MY DSO MANAGER sepa qué tipo de archivo se envía
(los archivos de Clientes deben comenzar por "clientes", los archivos de Documentos por "documentos" y los archivos Contactos por "contactos")
Envíe estos archivos
Los datos son procesados y actualizados de forma instantánea en su cuenta. El archivo enviado se sustituye por un archivo de informe que le indica si todo ha ido bien y cuántas modificaciones ha habido.

Vista general utilizando el software FileZilla para enviar sus archivos:

Esta vista general muestra una importación manual, pero puede convertirla en automática creando un script que envíe archivos CSV.

Cómo automatizar el envío mediante FTP seguro:

Enviar vía curl (Windows, Linux):

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

Enviar vía LFTP (Linux, Windows via cygwin):

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

Enviar vía WinSCP (Windows):

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

¡Gracias a nuestros conectores, puede importar sus datos de clientes y los datos contables (facturas, abonos...) de forma sencilla y automatizada!

Para ello, seleccione su software de gestión y siga las siguientes instrucciones para sincronizar sus datos con My DSO Manager con la frecuencia que desee (cada día, cada semana o manualmente).