全球商业网络
  1. 1.采购Baas
全球商业网络
  • 接口文档
    • 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. 1.采购Baas

2.数据样例

1.企业注册#

接口:https://apifox.com/apidoc/shared-59d4ffb6-d518-4f92-8dcf-d2bd2bfce9c4/api-100739113
关键字段如下:
{
  "name": "比亚迪股份有限公司", //企业名称
  "taxNo": "91440300192317458F", //企业税号
  "mailbox": "91440300192317458F@baas.com", //企业邮箱,如果没有 使用 税号@访问域名 , 如: 税号@baas.com
  "documentProfileIds": ["yonyou.request.for.quotation.cn.1.0","yonyou.quotation.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.request.for.quotation.cn.1.0",
  "documentContent": "" // xml ubl 文档 内容
 }
UBL文档说明
<RequestForQuotation
        xmlns="urn:oasis:names:specification:ubl:schema:xsd:RequestForQuotation-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:request:for:quotation:cn:ver1.0</cbc:ProfileID>
    <!-- 文档id -->
    <cbc:ID>01h2vwqktkf4pew41kf2xj4yrs</cbc:ID>
    <!-- 固定值 -->
    <cbc:CopyIndicator>false</cbc:CopyIndicator>
    <!-- 文档id uid转uuid -->
    <cbc:UUID>84E081CE-F9D1-94C5-40F9-94C5FF9D1AC3</cbc:UUID>
    <!-- 询价提交日期 : yyyy-MM-dd-->
    <cbc:IssueDate>2005-06-22</cbc:IssueDate>
    <!-- 询价提交时间 : HH:mm:ss -->
    <cbc:IssueTime>10:22:33</cbc:IssueTime>
    <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>
        <!-- 询价单据编码(baas系统里面的单据编码或标识) -->
        <cbc:ID>20230615123752</cbc:ID>
        <!-- 固定值 -->
        <cbc:DocumentTypeCode listID="urn:yonyou.com:api:1.0:documenttypecode">YY_DOCUMENT_NUMBER</cbc:DocumentTypeCode>
    </cac:AdditionalDocumentReference>
    <!-- 原始购方信息【文档发送方】 -->
    <cac:OriginatorCustomerParty>
        <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>
            </cac:Contact>
        </cac:Party>
    </cac:OriginatorCustomerParty>
    <!-- 卖方信息  【文档接收方】 -->
    <cac:SellerSupplierParty>
        <cac:Party>
            <cac:PartyName>
                <cbc:Name>供应商公司名称</cbc:Name>
            </cac:PartyName>
            <cac:PartyIdentification>
                <!-- 购方公司税号 -->
                <cbc:ID schemeID="CN:VAT">91440300192317458F</cbc:ID>
            </cac:PartyIdentification>
        </cac:Party>
    </cac:SellerSupplierParty>
    <!-- 收货信息 -->
    <cac:Delivery>
        <!-- 收货地址 -->
        <cac:DeliveryAddress>
            <!-- 街道地址,如果地址只有一行数据全部放StreetNam里面  -->
            <cbc:StreetName>中关村东大街XX号</cbc:StreetName>
            <cbc:BuildingName>海淀科技大厦</cbc:BuildingName>
            <cbc:BuildingNumber>A座</cbc:BuildingNumber>
            <cbc:District>海淀区</cbc:District>
            <cbc:CityName>北京市</cbc:CityName>
            <cbc:Floor>3层</cbc:Floor>
            <cbc:Room>3507室</cbc:Room>
            <!-- 收获地址国家简码 中国CN ,没有默认CN  -->
            <cac:Country>
                <cbc:IdentificationCode>CN</cbc:IdentificationCode>
            </cac:Country>
        </cac:DeliveryAddress>
        <!-- 收获要求日期 -->
        <cac:RequestedDeliveryPeriod>
            <!-- 询价开始日期 时间 -->
            <cbc:StartDate>2005-06-29</cbc:StartDate>
            <cbc:StartTime>09:30:47</cbc:StartTime>
            <!-- 询价结束日期 时间 -->
            <cbc:EndDate>2005-06-29</cbc:EndDate>
            <cbc:EndTime>09:30:47</cbc:EndTime>
        </cac:RequestedDeliveryPeriod>
    </cac:Delivery>
    <!-- 目的地国家 可选 -->
    <cac:DestinationCountry>
        <cbc:IdentificationCode>CN</cbc:IdentificationCode>
        <cbc:Name>中国</cbc:Name>
    </cac:DestinationCountry>
    <!-- 询价行 -->
    <cac:RequestForQuotationLine>
        <!-- 行序号 从1开始 -->
        <cbc:ID>1</cbc:ID>
        <!-- 物料明细 -->
        <cac:LineItem>
            <!-- 物料序号 从1开始 -->
            <cbc:ID>1</cbc:ID>
            <!-- 物料数量 -->
            <cbc:Quantity unitCode="单位">商品数量</cbc:Quantity>
            <cac:Item>
                <!-- 物料描述 填写备注 -->
                <cbc:Description>备注</cbc:Description>
                <!-- 物料名称 -->
                <cbc:Name>商品名称</cbc:Name>
                <cbc:BrandName>品牌</cbc:BrandName>
                <cbc:ModelName>商品型号</cbc:ModelName>
                <!-- 商品品类编码 -->
                <cac:CatalogueItemIdentification>
                    <cbc:ID>A0001</cbc:ID>
                </cac:CatalogueItemIdentification>
            </cac:Item>
        </cac:LineItem>
    </cac:RequestForQuotationLine>
</RequestForQuotation>

3.报价单文档发送#

接口: 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.quotation.cn.1.0",
  "documentContent": "" // xml ubl 文档 内容
 }
UBL文档说明
<Quotation
        xmlns="urn:oasis:names:specification:ubl:schema:xsd:Quotation-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:quotation:cn:ver1.0</cbc:ProfileID>
    <!-- 文档id uid -->
    <cbc:ID>01H754N4QNBE87W6FBEVHEJHFF</cbc:ID>
    <!-- 固定值 -->
    <cbc:CopyIndicator>false</cbc:CopyIndicator>
    <!-- 文档id uid转uuid -->
    <cbc:UUID>84E081CE-F9D1-94C5-40F9-94C5FF9D1AC3</cbc:UUID>
    <!-- 报价提交日期 : yyyy-MM-dd-->
    <cbc:IssueDate>2023-08-08</cbc:IssueDate>
    <!-- 报价提交时间 : HH:mm:ss -->
    <cbc:IssueTime>10:22:33</cbc:IssueTime>
    <!-- 备注信息 -->
    <cbc:Note>备注测试信息</cbc:Note>

    <cac:AdditionalDocumentReference>
        <!-- 和文档id一致 -->
        <cbc:ID>01H754N4QNBE87W6FBEVHEJHFF</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>
        <!-- 报价单据编码(baas系统里面的单据编码或标识) -->
        <cbc:ID>20230615123752</cbc:ID>
        <!-- 固定值 -->
        <cbc:DocumentTypeCode listID="urn:yonyou.com:api:1.0:documenttypecode">YY_DOCUMENT_NUMBER</cbc:DocumentTypeCode>
    </cac:AdditionalDocumentReference>
    <!-- 报价有效期 -->
    <cac:ValidityPeriod>
        <cbc:StartDate>2023-06-29</cbc:StartDate>
        <cbc:StartTime>09:30:47</cbc:StartTime>
        <cbc:EndDate>2023-08-29</cbc:EndDate>
        <cbc:EndTime>09:30:47</cbc:EndTime>
    </cac:ValidityPeriod>
    <!-- 关联的询价单单据信息 -->
    <cac:RequestForQuotationDocumentReference>
        <!-- 询价单文档id -->
        <cbc:ID>01H756HMJH277KAWVN6YV1A2NF</cbc:ID>
        <!-- 询价单文档id 转uuid,-->
        <cbc:UUID>8D076867-AE6D-439F-8281-5AAFC7F4E3B1</cbc:UUID>
        <!--询价日期 -->
        <cbc:IssueDate>2023-08-08</cbc:IssueDate>
    </cac:RequestForQuotationDocumentReference>
    <!-- 供应商信息  【文档发送方】 -->
    <cac:SellerSupplierParty>
        <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>
                    <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:SellerSupplierParty>
    <!-- 购方信息【文档接收方】 -->
    <cac:OriginatorCustomerParty>
        <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>上海市浦东新区葵涌街道延安路一号</cbc:StreetName>
                <cac:Country>
                    <cbc:IdentificationCode>CN</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:Contact>
                <cbc:Name>李四</cbc:Name>
                <cbc:Telephone>0755-89888888</cbc:Telephone>
            </cac:Contact>
        </cac:Party>
    </cac:OriginatorCustomerParty>

    <!-- 收货信息 -->
    <cac:Delivery>
        <cac:DeliveryAddress>
            <cbc:StreetName>中关村东大街2号</cbc:StreetName>
            <cbc:BuildingName>海淀科技大厦</cbc:BuildingName>
            <cbc:BuildingNumber>A座</cbc:BuildingNumber>
            <cbc:District>海淀区</cbc:District>
            <cbc:CityName>北京市</cbc:CityName>
            <cbc:Floor>3层</cbc:Floor>
            <cbc:Room>3507室</cbc:Room>
            <cac:Country>
                <cbc:IdentificationCode>CN</cbc:IdentificationCode>
            </cac:Country>
        </cac:DeliveryAddress>
        <!-- 收获要求日期 -->
        <cac:RequestedDeliveryPeriod>
            <cbc:StartDate>2023-06-29</cbc:StartDate>
            <cbc:StartTime>09:30:47</cbc:StartTime>
            <cbc:EndDate>2023-08-29</cbc:EndDate>
            <cbc:EndTime>09:30:47</cbc:EndTime>
        </cac:RequestedDeliveryPeriod>
    </cac:Delivery>
    <!-- 发货特殊事项说明 -->
    <cac:DeliveryTerms>
        <cbc:SpecialTerms>根据合同规定,延迟交货可扣除1%</cbc:SpecialTerms>
    </cac:DeliveryTerms>
    <!-- 付款方式 -->
    <cac:PaymentMeans>
        <!-- 付款方式编码 -->
        <cbc:PaymentMeansCode>20</cbc:PaymentMeansCode>
        <!-- 收款资金账号信息 -->
        <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>
            <cac:Country>
                <!-- 收款方公司国家简码 中国CN ,没有默认CN  -->
                <cbc:IdentificationCode>CN</cbc:IdentificationCode>
            </cac:Country>
        </cac:PayeeFinancialAccount>
    </cac:PaymentMeans>
    <!-- 交易条件描述 -->
    <cac:TransactionConditions>
        <cbc:Description>需要签署采购订单;付款方式为银行存款帐户或支票</cbc:Description>
    </cac:TransactionConditions>
    <!-- 折扣/附加费用标识 -->
    <cac:AllowanceCharge>
        <!-- false 为折扣 -->
        <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
        <!-- 折扣原因编码 -->
        <cbc:AllowanceChargeReasonCode>17</cbc:AllowanceChargeReasonCode>
        <!-- 折扣比例 -->
        <cbc:MultiplierFactorNumeric>0.10</cbc:MultiplierFactorNumeric>
        <!-- 折扣金额 -->
        <cbc:Amount currencyID="CNY">10.00</cbc:Amount>
    </cac:AllowanceCharge>
    <!-- 目的地国家 可选 -->
    <cac:DestinationCountry>
        <cbc:IdentificationCode>CN</cbc:IdentificationCode>
        <cbc:Name>中国</cbc:Name>
    </cac:DestinationCountry>
    <!-- 税额 -->
    <cac:TaxTotal>
        <cbc:TaxAmount currencyID="CNY">17.50</cbc:TaxAmount>
        <cbc:TaxEvidenceIndicator>false</cbc:TaxEvidenceIndicator>
        <cac:TaxSubtotal>
            <cbc:TaxableAmount currencyID="CNY">100.00</cbc:TaxableAmount>
            <cbc:TaxAmount currencyID="CNY">17.50</cbc:TaxAmount>
            <cbc:Percent>10.0</cbc:Percent>
        </cac:TaxSubtotal>
    </cac:TaxTotal>
    <!-- 报价总金额 -->
    <cac:QuotedMonetaryTotal>
        <!-- 折扣前金额 -->
        <cbc:LineExtensionAmount currencyID="CNY">100.00</cbc:LineExtensionAmount>
        <!--折扣后金额,税前金额 -->
        <cbc:TaxExclusiveAmount currencyID="CNY">90.00</cbc:TaxExclusiveAmount>
        <!-- 付款金额 -->
        <cbc:PayableAmount currencyID="CNY">107.50</cbc:PayableAmount>
    </cac:QuotedMonetaryTotal>
    <!-- 与询价单对应 -->
    <cac:QuotationLine>
        <cbc:ID>1</cbc:ID>
        <cac:LineItem>
            <cbc:ID>1</cbc:ID>
            <cbc:Quantity unitCode="辆">1</cbc:Quantity>
            <!-- 销售金额 -->
            <cbc:LineExtensionAmount currencyID="CNY">100.00</cbc:LineExtensionAmount>
            <!-- 税额 -->
            <cbc:TotalTaxAmount currencyID="CNY">17.50</cbc:TotalTaxAmount>
            <cac:Price>
                <!-- 单价 -->
                <cbc:PriceAmount currencyID="CNY">100.00</cbc:PriceAmount>
                <!-- 单位 和 说凉 -->
                <cbc:BaseQuantity unitCode="辆">1</cbc:BaseQuantity>
            </cac:Price>
            <cac:Item>
                <cbc:Description>超混旗舰 颠覆燃油</cbc:Description>
                <cbc:Name>唐DM-i</cbc:Name>
                <cbc:BrandName>唐</cbc:BrandName>
                <cbc:ModelName>冠军版</cbc:ModelName>
                <cac:CatalogueItemIdentification>
                    <cbc:ID>A0001</cbc:ID>
                </cac:CatalogueItemIdentification>
            </cac:Item>
        </cac:LineItem>
    </cac:QuotationLine>
</Quotation>

4.数据事件通知#

接口定义:https://apifox.com/apidoc/shared-59d4ffb6-d518-4f92-8dcf-d2bd2bfce9c4/api-100700730
需要采购baas定义,并暴露出来,接收的数据格式如下:
 {
       "clientId":"客户端id",
       "data":"加密的密文",
       "alg":"SM4/ECB/PKCS5Padding",
       "s1":"客户端密钥的开始位置", //截取客户端密钥作为 加密的key
       "s2":"客户端密钥的结束位置"
       
 }

5.拉取UBL文档#

接口:https://apifox.com/apidoc/shared-59d4ffb6-d518-4f92-8dcf-d2bd2bfce9c4/api-100701863
返回ubl内容,参考发送ubl内容
上一页
1.对接说明
下一页
1.对接说明
Built with