06. Contract

← トランザクション個別解説 目次へ戻る



06.01. MasterAgreementRequest

click here to expand/close XML view
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE cXML SYSTEM "https://electric-blue-industries.com/schemas/cXML/1.2.052/Contract.dtd">
<!--
 * Author:      Electric Blue Industries Ltd.
 * Author URI:  https://electric-blue-industries.com/
 * Copyright:   (c)2015-2023 Electric Blue Industries Ltd.
 * Contact:     admin@electric-blue-industris.com
 * License:     GNU General Public License v3.0
 * License URI: http://www.gnu.org/licenses/gpl-3.0.html
 * Reference:   http://xml.cxml.org/current/cXMLReferenceGuide.pdf
-->
<cXML timestamp="0000-00-00T00:00:00+09:00" payloadID="">
    <Header>
        <From>
            <Credential domain="DUNS">
                <Identity>123456789</Identity>
            </Credential>
        </From>
        <To>
            <Credential domain="NetworkID">
                <Identity>AN01000000001</Identity>
            </Credential>
        </To>
        <Sender>
            <Credential domain="DUNS">
                <Identity>123456789</Identity>
                <SharedSecret>SharedSecret</SharedSecret>
                <CredentialMac
                    type="FromSenderCredentials"
                    algorithm="HMAC-SHA1-96"
                    creationDate="0000-00-00T00:00:00+09:00"
                    expirationDate="0000-00-00T00:00:00+09:00">CredentialMAC</CredentialMac>
            </Credential>
            <UserAgent>Procurement Application Name</UserAgent>
        </Sender>
    </Header>
    <Request>
        <MasterAgreementRequest>
            <MasterAgreementRequestHeader agreementID="MA123" agreementDate="2001-12-01" type="value" effectiveDate="2002-01-01" expirationDate="2002-12-31" operation="new">
                <MaxAmount>
                    <Money currency="USD">10000</Money>
                </MaxAmount>
                <MaxReleaseAmount>
                    <Money currency="USD">10000</Money>
                </MaxReleaseAmount>
                <Contact role="BuyerLocation">
                    <Name xml:lang="en">Buyer Company</Name>
                    <PostalAddress name="default">
                        <DeliverTo>Joe Smith</DeliverTo>
                        <DeliverTo>Mailstop M-543</DeliverTo>
                        <Street>123 Anystreet</Street>
                        <City>Sunnyvale</City>
                        <State isoStateCode="US-CA">CA</State>
                        <PostalCode>90489</PostalCode>
                        <Country isoCountryCode="US">United States</Country>
                    </PostalAddress>
                </Contact>
                <Comments xml:lang="en-US">well formed XML can go here.</Comments>
            </MasterAgreementRequestHeader>
            <AgreementItemOut maxQuantity="100">
                <MaxAmount>
                    <Money currency="USD">1000</Money>
                </MaxAmount>
                <MaxReleaseAmount>
                    <Money currency="USD">100</Money>
                </MaxReleaseAmount>
                <ItemOut quantity="1">
                    <ItemID>
                        <SupplierPartID>1233244</SupplierPartID>
                    </ItemID>
                    <ItemDetail>
                        <UnitPrice>
                            <Money currency="USD">1.34</Money>
                        </UnitPrice>
                        <Description xml:lang="en">Blue Ballpoint Pen</Description>
                        <UnitOfMeasure>EA</UnitOfMeasure>
                        <Classification domain="UNSPSC">12345</Classification>
                        <ManufacturerPartID>234</ManufacturerPartID>
                        <ManufacturerName>foobar</ManufacturerName>
                        <URL>www.foo.com</URL>
                    </ItemDetail>
                    <Shipping trackingDomain="FedEx" trackingId="1234567890">
                        <Money currency="USD">2.5</Money>
                        <Description xml:lang="en-us">FedEx 2-day</Description>
                    </Shipping>
                    <Comments xml:lang="en-US">Any well formed XML</Comments>
                </ItemOut>
            </AgreementItemOut>
        </MasterAgreementRequest>
    </Request>
</cXML>

下記が返送されるMasterAgreementResponseの例です。他のAPIと同様にHeaderは存在しません。

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE cXML SYSTEM "https://electric-blue-industries.com/schemas/cXML/1.2.052/cXML.dtd">
<cXML>
    <Response>
        <MasterAgreementResponse effectiveDate="2023-07-01T05:24:29-08:00" lastRefresh="2023-07-08T05:24:29-08:00">
            
        </MasterAgreementResponse>
    </Response>
</cXML>

06.02. ContractRequest

click here to expand/close XML view
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE cXML SYSTEM "https://electric-blue-industries.com/schemas/cXML/1.2.052/Contract.dtd">
<!--
 * Author:      Electric Blue Industries Ltd.
 * Author URI:  https://electric-blue-industries.com/
 * Copyright:   (c)2015-2023 Electric Blue Industries Ltd.
 * Contact:     admin@electric-blue-industris.com
 * License:     GNU General Public License v3.0
 * License URI: http://www.gnu.org/licenses/gpl-3.0.html
 * Reference:   http://xml.cxml.org/current/cXMLReferenceGuide.pdf
-->
<cXML timestamp="0000-00-00T00:00:00+09:00" payloadID="">
    <Header>
        <From>
            <Credential domain="DUNS">
                <Identity>123456789</Identity>
            </Credential>
        </From>
        <To>
            <Credential domain="NetworkID">
                <Identity>AN01000000001</Identity>
            </Credential>
        </To>
        <Sender>
            <Credential domain="DUNS">
                <Identity>123456789</Identity>
                <SharedSecret>SharedSecret</SharedSecret>
                <CredentialMac
                    type="FromSenderCredentials"
                    algorithm="HMAC-SHA1-96"
                    creationDate="0000-00-00T00:00:00+09:00"
                    expirationDate="0000-00-00T00:00:00+09:00">CredentialMAC</CredentialMac>
            </Credential>
            <UserAgent>Procurement Application Name</UserAgent>
        </Sender>
    </Header>
    <Request>
        <ContractRequest>
            <ContractRequestHeader operation="new" xml:lang="en" expirationDate="2016-01-30T00:00:00-00:00" effectiveDate="2016-01-11T00:00:00-00:00" type="value" agreementDate="2016-01-12T00:00:00-00:00" createDate="2016-01-11T23:36:18+08:00" contractID="CW2009">
                <LegalEntity domain="CompanyCode">100</LegalEntity>
                <OrganizationID>
                    <Credential domain="NetworkID">
                        <Identity>AN02000000120</Identity>
                    </Credential>
                    <Credential domain="sap">
                        <Identity>0000000100</Identity>
                    </Credential>
                </OrganizationID>
                <OrganizationalUnit domain="PurchasingOrganization">1001</OrganizationalUnit>
                <OrganizationalUnit domain="PurchasingGroup">10101</OrganizationalUnit>
                <PaymentTerm payInNumberOfDays="10">
                    <Discount>
                        <DiscountPercent percent="2"></DiscountPercent>
                    </Discount>
                    <Extrinsic name="Id">0001</Extrinsic>
                </PaymentTerm>
                <MaxAmount>
                    <Money currency="USD">2000.00</Money>
                </MaxAmount>
                <TermsOfDelivery>
                    <TermsOfDeliveryCode value="TransportCondition"/>
                    <ShippingPaymentMethod value ="Other"/>
                    <TransportTerms value="FOB">Free on board vessel</TransportTerms>
                </TermsOfDelivery>
            </ContractRequestHeader>
            <ContractItemIn>
                <TermsOfDelivery>
                    <TermsOfDeliveryCode value="TransportCondition"/>
                    <ShippingPaymentMethod value ="Other"/>
                    <TransportTerms value="FOB">Free on board vessel</TransportTerms>
                </TermsOfDelivery>
                <ItemIn lineNumber="1" quantity="100" itemClassification="material">
                    <ItemID>
                        <SupplierPartID>1</SupplierPartID>
                        <SupplierPartAuxiliaryID></SupplierPartAuxiliaryID>
                        <BuyerPartID>992</BuyerPartID> <!-- Material code -->
                    </ItemID>
                    <ItemDetail>
                        <UnitPrice>
                            <Money currency="USD">1000.00</Money>
                            <Modifications>
                                <Modification>
                                    <AdditionalDeduction type="DISCOUNT">
                                        <DeductionAmount>
                                            <Money currency="USD">10.00</Money>
                                        </DeductionAmount>
                                    </AdditionalDeduction>
                                </Modification>
                                <Modification>
                                    <AdditionalDeduction type="DISCOUNT">
                                        <DeductionPercent percent="20"/>
                                    </AdditionalDeduction>
                                </Modification>
                                <Modification>
                                    <AdditionalCost>
                                        <Money currency="USD">30.00</Money>
                                    </AdditionalCost>
                                </Modification>
                                <Modification>
                                    <AdditionalCost>
                                        <Percentage percent="20"/>
                                    </AdditionalCost>
                                </Modification>
                            </Modifications>
                        </UnitPrice>
                        <Description xml:lang="en">Laptops</Description>
                        <UnitOfMeasure>EA</UnitOfMeasure>
                        <Classification domain="unspsc">43211503</Classification>
                        <Classification domain="MaterialGroup">29</Classification>
                        <ManufacturerPartID></ManufacturerPartID>
                        <ManufacturerName></ManufacturerName>
                        <URL></URL>
                        <LeadTime>2</LeadTime>
                    </ItemDetail>
                    <ShipTo>
                        <Address addressID="3000" addressIDDomain="buyerLocationID" isoCountryCode="US">
                            <Name xml:lang="en" >Plant 3000</Name>
                        </Address>
                    </ShipTo>
                </ItemIn>
                <ReferenceDocumentInfo lineNumber = "10">
                    <DocumentInfo documentID = "PR1234" documentType = "Requisition" documentDate = "2015-11-07T07:03:34-05:00">
                    </DocumentInfo>
                </ReferenceDocumentInfo>
                <ReferenceDocumentInfo lineNumber = "3">
                    <DocumentInfo documentID = "RFQ2345" documentType = "RFQ" documentDate = "2015-11-07T07:03:34-05:00"></DocumentInfo>
                </ReferenceDocumentInfo>
            </ContractItemIn>
        </ContractRequest>
    </Request>
</cXML>

下記が返送されるContractResponseの例です。他のAPIと同様にHeaderは存在しません。

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE cXML SYSTEM "https://electric-blue-industries.com/schemas/cXML/1.2.052/cXML.dtd">
<cXML>
    <Response>
        <ContractResponse effectiveDate="2023-07-01T05:24:29-08:00" lastRefresh="2023-07-08T05:24:29-08:00">
            
        </ContractResponse>
    </Response>
</cXML>

06.03. ContractStatusUpdateRequest

click here to expand/close XML view
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE cXML SYSTEM "https://electric-blue-industries.com/schemas/cXML/1.2.052/Contract.dtd">
<!--
 * Author:      Electric Blue Industries Ltd.
 * Author URI:  https://electric-blue-industries.com/
 * Copyright:   (c)2015-2023 Electric Blue Industries Ltd.
 * Contact:     admin@electric-blue-industris.com
 * License:     GNU General Public License v3.0
 * License URI: http://www.gnu.org/licenses/gpl-3.0.html
 * Reference:   http://xml.cxml.org/current/cXMLReferenceGuide.pdf
-->
<cXML timestamp="0000-00-00T00:00:00+09:00" payloadID="">
    <Header>
        <From>
            <Credential domain="DUNS">
                <Identity>123456789</Identity>
            </Credential>
        </From>
        <To>
            <Credential domain="NetworkID">
                <Identity>AN01000000001</Identity>
            </Credential>
        </To>
        <Sender>
            <Credential domain="DUNS">
                <Identity>123456789</Identity>
                <SharedSecret>SharedSecret</SharedSecret>
                <CredentialMac
                    type="FromSenderCredentials"
                    algorithm="HMAC-SHA1-96"
                    creationDate="0000-00-00T00:00:00+09:00"
                    expirationDate="0000-00-00T00:00:00+09:00">CredentialMAC</CredentialMac>
            </Credential>
            <UserAgent>Procurement Application Name</UserAgent>
        </Sender>
    </Header>
    <Request>
        <ContractStatusUpdateRequest>
            <Status xml:lang="en-US" code="200" text="OK">Succeeded</Status>
            <ContractStatus type="created">
                <ContractIDInfo contractID="CW2009">
                    <IdReference identifier="55000000" domain="SAPAgreementId"/>
                </ContractIDInfo>
                <ContractItemStatus>
                    <ItemStatus type="created">
                        <ReferenceDocumentInfo lineNumber="1"/>
                    </ItemStatus>
                    <IdReference identifier="010" domain="SAPLineNumber"/>
                </ContractItemStatus>
                <ContractItemStatus>
                    <ItemStatus type="created">
                        <ReferenceDocumentInfo lineNumber="2"/>
                    </ItemStatus>
                    <IdReference identifier="020" domain="SAPLineNumber"/>
                </ContractItemStatus>
            </ContractStatus>
        </ContractStatusUpdateRequest>
    </Request>
</cXML>

下記が返送されるContractStatusUpdateResponseの例です。他のAPIと同様にHeaderは存在しません。

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE cXML SYSTEM "https://electric-blue-industries.com/schemas/cXML/1.2.052/cXML.dtd">
<cXML>
    <Response>
        <ContractStatusUpdateResponse effectiveDate="2023-07-01T05:24:29-08:00" lastRefresh="2023-07-08T05:24:29-08:00">
            
        </ContractStatusUpdateResponse>
    </Response>
</cXML>