全球商业网络
  1. 2.银企联
全球商业网络
  • 接口文档
    • 1.认证授权
      • Oauth2认证
    • 2.企业管理
      • 企业注册接口
    • 3.文档管理
      • 1.发送UBL文档接口
      • 2.接收到文档通知接口
      • 3.根据文档id获取UBL文档内容
  • 业务文档
    • 1.企业信息
      • 1.企业信息字典信息
    • 2.UBL文档
      • 1.UBL文档说明
      • 2.文档profileId说明
      • 3.文档数据枚举定义
      • UBL示例说明
        • RemittanceAdvice
        • RequestForQuotation
        • Quotation
        • Enquiry
        • EnquiryResponse
  • 产品目标
    • 1.商业网络818发布
      • 1.商业网络818目标
  • 产品对接
    • 1.采购Baas
      • 1.对接说明
      • 2.数据样例
    • 2.银企联
      • 1.对接说明
      • 2.数据样例
  1. 2.银企联

2.数据样例

1.企业注册#

接口:https://apifox.com/apidoc/shared-59d4ffb6-d518-4f92-8dcf-d2bd2bfce9c4/api-100739113
关键字段如下:
{
  "name": "比亚迪股份有限公司", //企业名称
  "taxNo": "91440300192317458F", //企业税号
  "mailbox": "C0002@yql.com", //企业邮箱,如果没有 使用 客户号@访问域名 , 如: C00011@yql.com
  "documentProfileIds": ["yonyou.remittance.advice.cn.1.0"] // 注册文档 profileId
}

2.付款通知单发送#

接口:https://apifox.com/apidoc/shared-59d4ffb6-d518-4f92-8dcf-d2bd2bfce9c4/api-99332413
{
  "id": "01H74K04VREKAKB0JGSKV0J2VC", // 文档id
  "senderIdentifierScheme": "CN:VAT", //税号固定值
  "senderIdentifierValue":  "91440300192317458F",// 发送方公司税号
  "receiverIdentifierScheme": "CN:VAT", //税号固定值
  "receiverIdentifierValue": "91310000748059571K", // 接收方公司税号
  "documentProfileId": "yonyou.remittance.advice.cn.1.0", //
  "documentContent": "" // xml ubl 文档 内容
 }
UBL文档说明
<RemittanceAdvice
        xmlns="urn:oasis:names:specification:ubl:schema:xsd:RemittanceAdvice-2"
        xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
        xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
    <!-- 固定值 -->
    <cbc:UBLVersionID>2.3</cbc:UBLVersionID>
    <!-- 固定值 -->
    <cbc:CustomizationID>urn:yonyou.com:ubl-2.3-customizations:2021-06</cbc:CustomizationID>
    <!-- 固定值 -->
    <cbc:ProfileID schemeAgencyID="http://yonyou.com">urn:yonyou.com:profile:remittance.advice:cn:ver1.0</cbc:ProfileID>
    <!-- 文档id -->
    <cbc:ID>01H74S531ZJTBS7FQC35GB59VV</cbc:ID>
    <!-- 固定值 -->
    <cbc:CopyIndicator>false</cbc:CopyIndicator>
    <!-- 文档id uid转uuid -->
    <cbc:UUID>23275254-3a28-47f2-908e-530fbba1c1da</cbc:UUID>
    <!-- 付款日期  yyyy-MM-dd -->
    <cbc:IssueDate>2023-08-06</cbc:IssueDate>
    <!-- 付款时间  HH:mm:ss -->
    <cbc:IssueTime>11:22:33</cbc:IssueTime>
    <!-- 附言 -->
    <cbc:Note>汽车装饰采购付款</cbc:Note>
    <!-- 交易金额  CNY 交易币种-->
    <cbc:TotalDebitAmount currencyID="CNY">15000.00</cbc:TotalDebitAmount>
    <!-- 固定值 -->
    <cbc:TotalCreditAmount currencyID="CNY">0.00</cbc:TotalCreditAmount>
    <!-- 交易金额 -->
    <cbc:TotalPaymentAmount currencyID="CNY">15000.00</cbc:TotalPaymentAmount>
    <cac:AdditionalDocumentReference>
        <!-- 文档id -->
        <cbc:ID>01H74S531ZJTBS7FQC35GB59VV</cbc:ID>
        <!-- 固定值 -->
        <cbc:DocumentTypeCode listID="urn:yonyou.com:api:1.0:documenttypecode">YY_REFERENCE_DOCUMENT_ID</cbc:DocumentTypeCode>
    </cac:AdditionalDocumentReference>
    <cac:AdditionalDocumentReference>
        <!-- 固定值 -->
        <cbc:ID>付款通知单</cbc:ID>
        <!-- 固定值 -->
        <cbc:DocumentTypeCode listID="urn:yonyou.com:api:1.0:documenttypecode">YY_DOCUMENT_TYPE</cbc:DocumentTypeCode>
    </cac:AdditionalDocumentReference>
    <cac:AdditionalDocumentReference>
        <!-- 用途 -->
        <cbc:ID>锂电池维修</cbc:ID>
        <!-- 固定值 -->
        <cbc:DocumentTypeCode listID="urn:yonyou.com:api:1.0:documenttypecode">YY_DOCUMENT_NAME</cbc:DocumentTypeCode>
    </cac:AdditionalDocumentReference>
    <cac:AdditionalDocumentReference>
        <!-- 交易流水号 -->
        <cbc:ID>20230615123752</cbc:ID>
        <!-- 固定值 -->
        <cbc:DocumentTypeCode listID="urn:yonyou.com:api:1.0:documenttypecode">YY_DOCUMENT_NUMBER</cbc:DocumentTypeCode>
    </cac:AdditionalDocumentReference>
    <cac:InvoicePeriod>
        <!-- 两个都填写付款日期  yyyy-MM-dd, 实际应该为合同付款计划周期 -->
        <cbc:StartDate>2023-08-06</cbc:StartDate>
        <cbc:EndDate>2023-08-06</cbc:EndDate>
    </cac:InvoicePeriod>
    <!-- 付款方信息 -->
    <cac:AccountingCustomerParty>
        <!-- 付款方客户编号 -->
        <cbc:CustomerAssignedAccountID>C0001</cbc:CustomerAssignedAccountID>
        <!-- 收款方客户编号 -->
        <cbc:SupplierAssignedAccountID>C2001</cbc:SupplierAssignedAccountID>
        <cac:Party>
            <cac:PartyName>
                <!-- 付款方公司名称 -->
                <cbc:Name>比亚迪股份有限公司</cbc:Name>
            </cac:PartyName>
            <cac:PartyIdentification>
                <!-- 付款方公司税号 -->
                <cbc:ID schemeID="CN:VAT">91440300192317458F</cbc:ID>
            </cac:PartyIdentification>
            <cac:PostalAddress>
                <!-- 付款方公司地址 -->
                <cbc:StreetName>深圳市大鹏新区葵涌街道延安路一号</cbc:StreetName>
                <cac:Country>
                    <!-- 付款方公司国家简码 中国CN ,没有默认CN  -->
                    <cbc:IdentificationCode>CN</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <!-- 付款方公司联系人信息 没有可以不需要 -->
            <cac:Contact>
                <cbc:Name>李四</cbc:Name>
                <cbc:Telephone>0755-89888888</cbc:Telephone>
                <cbc:ElectronicMail>bydpo@byd.com</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:AccountingCustomerParty>
    <!-- 收款方信息 -->
    <cac:AccountingSupplierParty>
        <!-- 付款方客户编号 -->
        <cbc:CustomerAssignedAccountID>C0001</cbc:CustomerAssignedAccountID>
        <cac:Party>
            <cac:PartyName>
                <!-- 收款方公司名称 -->
                <cbc:Name>用友汽车信息科技(上海)股份有限公司</cbc:Name>
            </cac:PartyName>
            <cac:PartyIdentification>
                <!-- 收款方公司税号 -->
                <cbc:ID schemeID="CN:VAT">91310000748059571K</cbc:ID>
            </cac:PartyIdentification>
            <cac:PostalAddress>
                <!-- 收款方公司地址 -->
                <cbc:StreetName>上海市嘉定工业区叶城路1288号1幢50138室</cbc:StreetName>
                <cac:Country>
                    <!-- 收款方公司国家简码 中国CN ,没有默认CN  -->
                    <cbc:IdentificationCode>CN</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <!-- 收款方公司联系人信息 没有可以不需要 -->
            <cac:Contact>
                <cbc:Name>张三</cbc:Name>
                <cbc:Telephone>021-62128038</cbc:Telephone>
                <cbc:ElectronicMail>zqb@yonyou.com</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:AccountingSupplierParty>
    <!-- 参考收款方信息 -->
    <cac:PayeeParty>
        <cac:PartyName>
            <cbc:Name>用友汽车信息科技(上海)股份有限公司</cbc:Name>
        </cac:PartyName>
        <cac:PostalAddress>
            <cbc:StreetName>上海市嘉定工业区叶城路1288号1幢50138室</cbc:StreetName>
            <cac:Country>
                <cbc:IdentificationCode>CN</cbc:IdentificationCode>
            </cac:Country>
        </cac:PostalAddress>
        <cac:Contact>
            <cbc:Name>张三</cbc:Name>
            <cbc:Telephone>021-62128038</cbc:Telephone>
            <cbc:ElectronicMail>zqb@yonyou.com</cbc:ElectronicMail>
        </cac:Contact>
    </cac:PayeeParty>
    <!-- 付款方式 -->
    <cac:PaymentMeans>
        <!-- 付款方式编码 -->
        <cbc:PaymentMeansCode>YQL</cbc:PaymentMeansCode>
        <!-- 付款到期时间,没有不填 -->
        <cbc:PaymentDueDate>2023-08-10</cbc:PaymentDueDate>
        <!-- 付款方信息-->
        <cac:PayerFinancialAccount>
            <!-- 付款方 付款账号 -->
            <cbc:ID>23232-0434-4342-343</cbc:ID>
            <!-- 付款方 付款账户名 -->
            <cbc:Name>比亚迪股份有限公司</cbc:Name>
            <!-- 付款账号类型 -->
            <cbc:AccountTypeCode>1001</cbc:AccountTypeCode>
            <!-- 币种编码 人民币 CNY -->
            <cbc:CurrencyCode>CNY</cbc:CurrencyCode>
            <!-- 付款方银行支行信息 没有不填  -->
            <cac:FinancialInstitutionBranch>
                <cbc:ID>10-26-58</cbc:ID>
                <cbc:Name>中国银行马当路分行</cbc:Name>
            </cac:FinancialInstitutionBranch>
            <!-- 付款方公司国家简码 中国CN ,没有默认CN  -->
            <cac:Country>
                <cbc:IdentificationCode>CN</cbc:IdentificationCode>
            </cac:Country>
        </cac:PayerFinancialAccount>
        <!-- 收款方信息 -->
        <cac:PayeeFinancialAccount>
            <!-- 收方账号 -->
            <cbc:ID>6000-0434-4342-343</cbc:ID>
            <!-- 收方户名 -->
            <cbc:Name>用友汽车信息科技(上海)股份有限公司</cbc:Name>
            <!-- 收方类型 -->
            <cbc:AccountTypeCode>1001</cbc:AccountTypeCode>
            <!-- 交易币种 -->
            <cbc:CurrencyCode>CNY</cbc:CurrencyCode>
            <!-- 收款方银行信息 -->
            <cac:FinancialInstitutionBranch>
                <!-- 收方开户行号 -->
                <cbc:ID>10-26-58</cbc:ID>
                <!-- 收方开户行名 -->
                <cbc:Name>招商银行马当路分行</cbc:Name>
                <cac:FinancialInstitution>
                    <!-- 收款人账户银行代号  -->
                    <cbc:ID>10-26-58</cbc:ID>
                    <cbc:Name>招商银行</cbc:Name>
                </cac:FinancialInstitution>
                <cac:Address>
                    <!-- 收方支行地址 -->
                    <cbc:StreetName>北京市海淀区</cbc:StreetName>
                    <!-- 收方支行城市 -->
                    <cbc:CityName>北京</cbc:CityName>
                    <cac:Country>
                        <!-- 收方银行所在国家编码 -->
                        <cbc:IdentificationCode>CN</cbc:IdentificationCode>
                    </cac:Country>
                </cac:Address>
            </cac:FinancialInstitutionBranch>
            <!-- 收款方公司国家简码 中国CN ,没有默认CN  -->
            <cac:Country>
                <cbc:IdentificationCode>CN</cbc:IdentificationCode>
            </cac:Country>
        </cac:PayeeFinancialAccount>
    </cac:PaymentMeans>
    <!-- 付款明细 -->
    <cac:RemittanceAdviceLine>
        <!-- 行序号,从1开始 -->
        <cbc:ID>1</cbc:ID>
        <!-- 汇款用途 -->
        <cbc:Note>请求到货款后签署后续合同</cbc:Note>
        <!-- 付款金额 -->
        <cbc:DebitLineAmount currencyID="CNY">15000.00</cbc:DebitLineAmount>
        <!-- 固定值 -->
        <cbc:CreditLineAmount currencyID="CNY">0.00</cbc:CreditLineAmount>
    </cac:RemittanceAdviceLine>
</RemittanceAdvice>
ubl数据构建可以使用 https://github.com/phax/ph-ubl/tree/master/ph-ubl23 开源工具,UBL23Marshaller(目前ubl使用的版本2.3), 参考:https://github.com/phax/ph-ubl/blob/master/ph-ubl23/src/test/java/com/helger/ubl23/UBL23FuncTest.java
方法 testReadAndWriteRemittanceAdvice
上一页
1.对接说明
Built with