2015-04-23 99 views
0

使用QuickBooks Online v3 API(https://developer.intuit.com/apiexplorer?apiname=V3QBOQuickbooks API Explorer - 如何将交易链接到发票?

如何创建付款,然后使用API​​ Explorer将该付款链接到现有发票?我正在使用沙箱进行所有测试。

例如,我在客户端创建了一个付款,这里是响应。

<IntuitResponse xmlns="http://schema.intuit.com/finance/v3" time="2015-04-23T04:27:18.490-07:00"> 

    <Payment domain="QBO" sparse="false"> 

    <Id>162</Id> 

    <SyncToken>0</SyncToken> 

    <MetaData> 

     <CreateTime>2015-04-23T04:28:55-07:00</CreateTime> 

     <LastUpdatedTime>2015-04-23T04:28:55-07:00</LastUpdatedTime> 

    </MetaData> 

    <TxnDate>2013-07-11</TxnDate> 

    <PrivateNote>Payment smoke test</PrivateNote> 

    <CustomerRef name="ZeanabArafat">61</CustomerRef> 

    <DepositToAccountRef>4</DepositToAccountRef> 

    <TotalAmt>200.00</TotalAmt> 

    <UnappliedAmt>200.00</UnappliedAmt> 

    <ProcessPayment>false</ProcessPayment> 

    </Payment> 

</IntuitResponse> 

我的付款是200美元。然后我创建了一张发票,这里是回应...

然后我创建了一个发票,我从API下面得到的回复。

<IntuitResponse xmlns="http://schema.intuit.com/finance/v3" time="2015-04-23T05:25:26.668-07:00"> 
    <Invoice domain="QBO" sparse="false"> 
    <Id>163</Id> 
    <SyncToken>0</SyncToken> 
    <MetaData> 
     <CreateTime>2015-04-23T05:26:58-07:00</CreateTime> 
     <LastUpdatedTime>2015-04-23T05:26:58-07:00</LastUpdatedTime> 
    </MetaData> 
    <CustomField> 
     <DefinitionId>1</DefinitionId> 
     <Name>Crew #</Name> 
     <Type>StringType</Type> 
    </CustomField> 
    <DocNumber>1049</DocNumber> 
    <TxnDate>2015-04-23</TxnDate> 
    <Line> 
     <Id>1</Id> 
     <LineNum>1</LineNum> 
     <Amount>2000.00</Amount> 
     <DetailType>SalesItemLineDetail</DetailType> 
     <SalesItemLineDetail> 
     <ItemRef name="Concrete">3</ItemRef> 
     <TaxCodeRef>NON</TaxCodeRef> 
     </SalesItemLineDetail> 
    </Line> 
    <Line> 
     <Amount>2000.00</Amount> 
     <DetailType>SubTotalLineDetail</DetailType> 
     <SubTotalLineDetail /> 
    </Line> 
    <TxnTaxDetail> 
     <TotalTax>0</TotalTax> 
    </TxnTaxDetail> 
    <CustomerRef name="ZeanabArafat">61</CustomerRef> 
    <BillAddr> 
     <Id>98</Id> 
     <Line1>2007 Sailborough Ct Winter Garden, FL 34787</Line1> 
     <Lat>28.522938</Lat> 
     <Long>-81.605711</Long> 
    </BillAddr> 
    <ShipAddr> 
     <Id>98</Id> 
     <Line1>2007 Sailborough Ct Winter Garden, FL 34787</Line1> 
     <Lat>28.522938</Lat> 
     <Long>-81.605711</Long> 
    </ShipAddr> 
    <DueDate>2015-05-23</DueDate> 
    <TotalAmt>2000.00</TotalAmt> 
    <ApplyTaxAfterDiscount>false</ApplyTaxAfterDiscount> 
    <PrintStatus>NeedToPrint</PrintStatus> 
    <EmailStatus>NotSet</EmailStatus> 
    <Balance>2000.00</Balance> 
    <Deposit>0</Deposit> 
    <AllowIPNPayment>false</AllowIPNPayment> 
    <AllowOnlinePayment>false</AllowOnlinePayment> 
    <AllowOnlineCreditCardPayment>false</AllowOnlineCreditCardPayment> 
    <AllowOnlineACHPayment>false</AllowOnlineACHPayment> 
    </Invoice> 
</IntuitResponse> 

我然后运行在API浏览器中的以下XML的发票上的更新命令只是为了测试,并确保它的工作原理,然后我仔细检查了,它没有更新中的UI发票私人评论沙箱......所以......迄今为止非常好。

<Invoice xmlns="http://schema.intuit.com/finance/v3" domain="QBO" sparse="true"> 

    <Id>163</Id> 

    <SyncToken>0</SyncToken> 

    <MetaData> 

     <CreateTime>2014-10-15T14:13:24-07:00</CreateTime> 

     <LastUpdatedTime>2014-10-15T14:13:24-07:00</LastUpdatedTime> 

    </MetaData> 

    <PrivateNote>Invoice update Test</PrivateNote> 

    </Invoice> 

所以这个工作。我得到了回应...

<IntuitResponse xmlns="http://schema.intuit.com/finance/v3" time="2015-04-23T05:30:04.336-07:00"> 
<Invoice domain="QBO" sparse="false"> <Id>163</Id> <SyncToken>1</SyncToken> <MetaData> <CreateTime>2015-04-23T05:26:58-07:00</CreateTime> <LastUpdatedTime>2015-04-23T05:31:36-07:00</LastUpdatedTime> </MetaData> <CustomField> <DefinitionId>1</DefinitionId> <Name>Crew #</Name> <Type>StringType</Type> </CustomField> <DocNumber>1049</DocNumber> <TxnDate>2015-04-23</TxnDate> <PrivateNote>Invoice update Test</PrivateNote> <Line> <Id>1</Id> <LineNum>1</LineNum> <Amount>2000.00</Amount> <DetailType>SalesItemLineDetail</DetailType> <SalesItemLineDetail> <ItemRef name="Concrete">3</ItemRef> <TaxCodeRef>NON</TaxCodeRef> </SalesItemLineDetail> </Line> <Line> <Amount>2000.00</Amount> <DetailType>SubTotalLineDetail</DetailType> <SubTotalLineDetail /> </Line> <TxnTaxDetail> <TotalTax>0</TotalTax> </TxnTaxDetail> <CustomerRef name="ZeanabArafat">61</CustomerRef> <BillAddr> <Id>98</Id> <Line1>2007 Sailborough Ct Winter Garden, FL 34787</Line1> <Lat>28.522938</Lat> <Long>-81.605711</Long> </BillAddr> <ShipAddr> <Id>98</Id> <Line1>2007 Sailborough Ct Winter Garden, FL 34787</Line1> <Lat>28.522938</Lat> <Long>-81.605711</Long> </ShipAddr> <DueDate>2015-05-23</DueDate> <TotalAmt>2000.00</TotalAmt> <ApplyTaxAfterDiscount>false</ApplyTaxAfterDiscount> <PrintStatus>NeedToPrint</PrintStatus> <EmailStatus>NotSet</EmailStatus> <Balance>2000.00</Balance> <Deposit>0</Deposit> <AllowIPNPayment>false</AllowIPNPayment> <AllowOnlinePayment>false</AllowOnlinePayment> <AllowOnlineCreditCardPayment>false</AllowOnlineCreditCardPayment> <AllowOnlineACHPayment>false</AllowOnlineACHPayment> </Invoice> </IntuitResponse> 

正如我说的在沙箱UI中看到的,我看到了结果。我在私人评论中看到我放置的文字。 (或声明备忘录区域)


现在为我的问题:试图将付款链接到交易。

根据我的文档和一些猜测工作,我假设我必须去更新发票,我需要为客户提供我的customerRef,更新SyncToken'1',并提供linkedtransaction xml我会发布我试图做的,所以你可以告诉我我做错了什么。请记住我的付款ID是162,我认为这是TxnId的含义?

所以我的新的XML命令来尝试并把这个时间是交易...

<Invoice xmlns="http://schema.intuit.com/finance/v3" domain="QBO" sparse="true"> 
    <Id>163</Id> 
    <SyncToken>1</SyncToken> 
    <MetaData> 
     <CreateTime>2014-10-15T14:13:24-07:00</CreateTime> 
     <LastUpdatedTime>2014-10-15T14:13:24-07:00</LastUpdatedTime> 
    </MetaData> 
    <PrivateNote>Invoice update Test</PrivateNote> 
    <LinkedTxn> 
     <TxnId>162</TxnId> 
    <TxnType>Payment</TxnType> 
</LinkedTxn> 
    </Invoice> 

这返回如下回应......

<IntuitResponse xmlns="http://schema.intuit.com/finance/v3" time="2015-04-23T05:40:03.383-07:00"> 
    <Invoice domain="QBO" sparse="false"> 
    <Id>163</Id> 
    <SyncToken>1</SyncToken> 
    <MetaData> 
     <CreateTime>2015-04-23T05:26:58-07:00</CreateTime> 
     <LastUpdatedTime>2015-04-23T05:31:36-07:00</LastUpdatedTime> 
    </MetaData> 
    <CustomField> 
     <DefinitionId>1</DefinitionId> 
     <Name>Crew #</Name> 
     <Type>StringType</Type> 
    </CustomField> 
    <DocNumber>1049</DocNumber> 
    <TxnDate>2015-04-23</TxnDate> 
    <PrivateNote>Invoice update Test</PrivateNote> 
    <Line> 
     <Id>1</Id> 
     <LineNum>1</LineNum> 
     <Amount>2000.00</Amount> 
     <DetailType>SalesItemLineDetail</DetailType> 
     <SalesItemLineDetail> 
     <ItemRef name="Concrete">3</ItemRef> 
     <TaxCodeRef>NON</TaxCodeRef> 
     </SalesItemLineDetail> 
    </Line> 
    <Line> 
     <Amount>2000.00</Amount> 
     <DetailType>SubTotalLineDetail</DetailType> 
     <SubTotalLineDetail /> 
    </Line> 
    <TxnTaxDetail> 
     <TotalTax>0</TotalTax> 
    </TxnTaxDetail> 
    <CustomerRef name="ZeanabArafat">61</CustomerRef> 
    <BillAddr> 
     <Id>98</Id> 
     <Line1>2007 Sailborough Ct Winter Garden, FL 34787</Line1> 
     <Lat>28.522938</Lat> 
     <Long>-81.605711</Long> 
    </BillAddr> 
    <ShipAddr> 
     <Id>98</Id> 
     <Line1>2007 Sailborough Ct Winter Garden, FL 34787</Line1> 
     <Lat>28.522938</Lat> 
     <Long>-81.605711</Long> 
    </ShipAddr> 
    <DueDate>2015-05-23</DueDate> 
    <TotalAmt>2000.00</TotalAmt> 
    <ApplyTaxAfterDiscount>false</ApplyTaxAfterDiscount> 
    <PrintStatus>NeedToPrint</PrintStatus> 
    <EmailStatus>NotSet</EmailStatus> 
    <Balance>2000.00</Balance> 
    <Deposit>0</Deposit> 
    <AllowIPNPayment>false</AllowIPNPayment> 
    <AllowOnlinePayment>false</AllowOnlinePayment> 
    <AllowOnlineCreditCardPayment>false</AllowOnlineCreditCardPayment> 
    <AllowOnlineACHPayment>false</AllowOnlineACHPayment> 
    </Invoice> 
</IntuitResponse> 

所以看起来像它的工作没有任何错误...但是当我去检查沙箱UI,看看它的连接?我没有看到任何东西,没有交易状态,发票上也没有变化?

我做错了什么?我错过了一步吗?

回答

0

我找到答案,招数是先创建发票然后通过付款引用发票。我正在做错误的顺序,在与intuit的版主交谈后,我确认这是一个错误。

使用类似这样的支付链接到发票

<Payment xmlns="http://schema.intuit.com/finance/v3"> 
    <CustomerRef name="Customer Name Here">61</CustomerRef> 
    <TotalAmt>500</TotalAmt> 
     <Line> 
     <Amount>500</Amount> 
     <LinkedTxn> 
      <TxnId>164</TxnId> 
      <TxnType>Invoice</TxnType> 
     </LinkedTxn> 
    </Line> 
</Payment> 

TxnID的发票编号,确保数量和总金额排队!

+0

谢谢!我到处寻找这个。 – Varun

相关问题