正在加载...
在线帮助
如您有任何问题，请联系我们

Automatic import »

How to import your data automatically?

Translate this page to Chinese (Simplified)Chinese (Simplified) ?
正在加载...
如要使用此界面，请使用脚本将您的未结项、客户、用户（可选）和联系人（可选）文件每晚（例如）或每天多次发送到我们的服务器.
此程序必须使用以下标识符、地址和语法发送 CSV 或 TXT 文件（POST 数据以分号分隔）:
how api works

通过我们的 API 登录您的帐户

如要登录，请使用此用户名和密码。:
网址 / URL:
https://account.mydsomanager.com/api/
您须登录才能查看此信息
示例 « Headers » 
POST ...
...
Authorization: 您须登录才能查看此信息
...

数据导入选项

仅在需要时使用这些选项:
参数 API 描述
encoding all 文件格式
可能的值: UTF-8 (默认值), ISO-8859-1, ...
clear_items_not_modified items 自动清除项目?
可能的值:
  • true:« STOCK » 模式 → 我系统性地导入所有未结项目（发票、贷项通知单、各种尚未付款和清算的交易等）。在这种情况下，如果某个项目出现在导入日期 'D'，但在下一个导入日期'D 1'中不再存在，MY DSO MANAGER 将自动清除该项目.
  • false:« DELTA » 模式 → 我倾向于进行部分导入（不一定导入所有未清项），并向MY DSO MANAGER 指明哪些项目已付款并已清算。可以通过以下两种方式进行操作：一是在客户表格的账户报表中手动清算这些项目；二是导入已清算的项目，并在导入时将'付款日期'字段填写为项目的清算日期.
默认值: false
replace_users_association users 替换客户/用户关联 或 仅添加新的客户/用户关联。?
可能的值: 0 或 1
默认值: 0
示例 « Headers » 和 « Data » 
POST /api/items?encoding=UTF-8&clear_items_not_modified=true HTTP/1.1
...

data...

添加和修改您的项目（发票、贷项通知单等）

使用 SSL 加密
CSV 文件的列项语法:
数列 描述
client_code * 公司代码
item_amount_initial 原金额 不含税
item_amount_initial_inc_tax * 原金额 含税
示例 / 可能的值:
  • 1200
  • 1 200,00
  • 1200.00123
  • ...
item_amount_remaining 剩余金额 不含税
item_amount_remaining_inc_tax 剩余金额 含税
item_business_case 交易名称
item_currency 货币
示例: EUR, USD, ...
item_date_due * 到期日
日期格式: YYYY-MM-DD
item_date_issue * 签发日期
日期格式: YYYY-MM-DD
item_date_order 订单日期
日期格式: YYYY-MM-DD
item_date_payment 付款日期
日期格式: YYYY-MM-DD
item_erp_type 企业资源管理系统中单据类别
item_file_number 档案号
item_number * 单据号码
item_order_number 客户订单号
item_sales_administrative 销售主管
item_sales_manager 销售经理
item_type * 单据类型Link
可能的值: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key 唯一单据识别名
示例 « Headers » 和 « Data » 
POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: 您须登录才能查看此信息
...

"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"
...
必填数列 : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

添加和修改您的客户数据

使用 SSL 加密
CSV 文件的列项语法:
数列 描述
client_address_city 地址 (城市)
client_address_country 地址 (国家)
client_address_postbox 地址 (邮局信箱)
client_address_state 地址 (省份 / 地区)
client_address_street 地址 (街道)
client_address_street_line2 地址 (街道 行 2)
client_address_street_line3 地址 (街道 行 3)
client_address_street_number 地址 (n° 街道)
client_address_zip 地址 (邮政编码)
client_blocked 账户被锁 (是 / 否)
可能的值: 0, 1 (默认值: 0 <=> 否)
client_blocked_date 账户被锁 / 日期
日期格式: YYYY-MM-DD
client_business_line 市场
client_business_name * 公司注册名
client_code * 公司代码
client_comments 备注
client_commercial_email 与客户关联的销售人员 / 邮件
client_commercial_fax 与客户关联的销售人员 / 传真
client_commercial_firstname 与客户关联的销售人员 / 名
client_commercial_lastname 与客户关联的销售人员 / 姓
client_commercial_matricule 与客户关联的销售人员 / 证件号码
client_commercial_phone 与客户关联的销售人员 / 电话
client_commercial_phone_cell 与客户关联的销售人员 / 手机号
client_credit_limit 风险 / 信用额度
client_email 邮件
client_fax 传真
client_group 集团
客户组列表（以逗号分隔）
client_guarantee_insurer 风险 / 担保方
client_guarantee_insurer_reference 风险 / 保险人资料
client_guarantee_score 风险 / 得分
client_guarantee_temporary 风险 / 临时担保
client_guarantee_temporary_date_end 风险 / 临时担保 / 结束日期
client_guarantee_temporary_date_start 风险 / 临时担保 / 开始日期
client_guarantee_type 风险 / 保证类型
client_guarantees_currency 风险 / 担保货币
client_id 公司注册号
client_order_backlog 订货清单
client_others_guarantees 风险 / 其他担保
client_payment_mean 付账方式
client_payment_term 付账期
client_phone 电话
client_phone_cell 手机号
client_siret Siret
(适用于法国公司)
client_trading_name 品牌名
client_unique_key 唯一客户识别名
client_url 网站
client_vat 增值税税号
示例 « Headers » 和 « Data » 
POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: 您须登录才能查看此信息
...

"client_business_name";"client_code";"client_id";"client_address_country"
"My company";"C0001";"FR12345678";"France"
...
必填数列 : client_code + client_business_name

为您的客户添加联系人

使用 SSL 加密
CSV 文件的列项语法:
数列 描述
client_code * 公司代码
contact_collection 催款联系人 (是 / 否)
可能的值: 0, 1 (默认值: 0 <=> 否)
contact_comments 备注
contact_email 邮件
contact_email_copy_collection_auto 在自动电子邮件中复制电子邮件 (是 / 否)
可能的值: 0, 1 (默认值: 0 <=> 否)
contact_fax 传真
contact_firstname 名
contact_lastname * 姓
contact_phone 电话
contact_phone_cell 手机号
contact_role 角色
可能的值:
  • accounting: 会计员
  • buyer: 购买方
  • company: 公司
  • manager: 领导人
  • other: 其他 (默认值)
contact_title 称呼 (先生，女士...)
contact_unique_key 唯一联络人识别名
示例 « Headers » 和 « Data » 
POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: 您须登录才能查看此信息
...

"contact_firstname";"contact_lastname";"contact_role";"client_code"
"Mike";"Jackson";"other";"C0001"
...
必填数列 : client_code + contact_lastname

将用户与您的客户关联

使用 SSL 加密
CSV 文件的列项语法:
数列 描述
client_code * 公司代码
user_email 邮件
user_firstname 名
user_lastname * 姓
user_matricule 证件号码
示例 « Headers » 和 « Data » 
POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: 您须登录才能查看此信息
...

"user_firstname";"user_lastname";"client_code"
"John";"Roy";"C0001"
...
必填数列 : client_code + user_lastname
If you want, you can use the path "/apiPutFiles/" to import the files asynchronously.

返回数据

执行 POST 请求后，MY DSO MANAGER 将立即处理这些数据，并返回错误信息（如有）或已添加和更新的数据量。.
此响应将采用 JSON 格式，并返回以下信息。:
字段 描述
success 指示导入是否成功
可能的值: true, false
error_code 错误代码（如有）
可能的值: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description 错误消息（如有）
exception_lines 忽略的行数（如存在）
nb_client_added 个客户已被添加
nb_client_modified 个客户已被修改
nb_contact_added 个联系方式已被添加
nb_item_added 个单据已被添加
nb_item_modified 个单据已被修改
nb_user_added 添加了个用户
nb_user_modified 更改了个用户
示例 « 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)",
	},
}
← 退回 : 在线帮助 » 各项问题