| <html><body> |
| <style> |
| |
| body, h1, h2, h3, div, span, p, pre, a { |
| margin: 0; |
| padding: 0; |
| border: 0; |
| font-weight: inherit; |
| font-style: inherit; |
| font-size: 100%; |
| font-family: inherit; |
| vertical-align: baseline; |
| } |
| |
| body { |
| font-size: 13px; |
| padding: 1em; |
| } |
| |
| h1 { |
| font-size: 26px; |
| margin-bottom: 1em; |
| } |
| |
| h2 { |
| font-size: 24px; |
| margin-bottom: 1em; |
| } |
| |
| h3 { |
| font-size: 20px; |
| margin-bottom: 1em; |
| margin-top: 1em; |
| } |
| |
| pre, code { |
| line-height: 1.5; |
| font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| } |
| |
| pre { |
| margin-top: 0.5em; |
| } |
| |
| h1, h2, h3, p { |
| font-family: Arial, sans serif; |
| } |
| |
| h1, h2, h3 { |
| border-bottom: solid #CCC 1px; |
| } |
| |
| .toc_element { |
| margin-top: 0.5em; |
| } |
| |
| .firstline { |
| margin-left: 2 em; |
| } |
| |
| .method { |
| margin-top: 1em; |
| border: solid 1px #CCC; |
| padding: 1em; |
| background: #EEE; |
| } |
| |
| .details { |
| font-weight: bold; |
| font-size: 14px; |
| } |
| |
| </style> |
| |
| <h1><a href="content_v2_1.html">Content API for Shopping</a> . <a href="content_v2_1.orderinvoices.html">orderinvoices</a></h1> |
| <h2>Instance Methods</h2> |
| <p class="toc_element"> |
| <code><a href="#close">close()</a></code></p> |
| <p class="firstline">Close httplib2 connections.</p> |
| <p class="toc_element"> |
| <code><a href="#createchargeinvoice">createchargeinvoice(merchantId, orderId, body=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Creates a charge invoice for a shipment group, and triggers a charge capture for orderinvoice enabled orders.</p> |
| <p class="toc_element"> |
| <code><a href="#createrefundinvoice">createrefundinvoice(merchantId, orderId, body=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Creates a refund invoice for one or more shipment groups, and triggers a refund for orderinvoice enabled orders. This can only be used for line items that have previously been charged using `createChargeInvoice`. All amounts (except for the summary) are incremental with respect to the previous invoice.</p> |
| <h3>Method Details</h3> |
| <div class="method"> |
| <code class="details" id="close">close()</code> |
| <pre>Close httplib2 connections.</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="createchargeinvoice">createchargeinvoice(merchantId, orderId, body=None, x__xgafv=None)</code> |
| <pre>Creates a charge invoice for a shipment group, and triggers a charge capture for orderinvoice enabled orders. |
| |
| Args: |
| merchantId: string, The ID of the account that manages the order. This cannot be a multi-client account. (required) |
| orderId: string, The ID of the order. (required) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { |
| "invoiceId": "A String", # [required] The ID of the invoice. |
| "invoiceSummary": { # [required] Invoice summary. |
| "additionalChargeSummaries": [ # Summary of the total amounts of the additional charges. |
| { |
| "totalAmount": { # [required] Total additional charge for this type. |
| "priceAmount": { # [required] The pre-tax or post-tax price depending on the location of the order. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "taxAmount": { # [required] Tax value. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| }, |
| "type": "A String", # [required] Type of the additional charge. Acceptable values are: - "`shipping`" |
| }, |
| ], |
| "productTotal": { # [required] Total price for the product. |
| "priceAmount": { # [required] The pre-tax or post-tax price depending on the location of the order. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "taxAmount": { # [required] Tax value. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| }, |
| }, |
| "lineItemInvoices": [ # [required] Invoice details per line item. |
| { |
| "lineItemId": "A String", # ID of the line item. Either lineItemId or productId must be set. |
| "productId": "A String", # ID of the product. This is the REST ID used in the products service. Either lineItemId or productId must be set. |
| "shipmentUnitIds": [ # [required] The shipment unit ID is assigned by the merchant and defines individual quantities within a line item. The same ID can be assigned to units that are the same while units that differ must be assigned a different ID (for example: free or promotional units). |
| "A String", |
| ], |
| "unitInvoice": { # [required] Invoice details for a single unit. |
| "additionalCharges": [ # Additional charges for a unit, e.g. shipping costs. |
| { |
| "additionalChargeAmount": { # [required] Amount of the additional charge. |
| "priceAmount": { # [required] The pre-tax or post-tax price depending on the location of the order. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "taxAmount": { # [required] Tax value. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| }, |
| "type": "A String", # [required] Type of the additional charge. Acceptable values are: - "`shipping`" |
| }, |
| ], |
| "unitPrice": { # [required] Pre-tax or post-tax price of the unit depending on the locality of the order. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "unitPriceTaxes": [ # Tax amounts to apply to the unit price. |
| { |
| "taxAmount": { # [required] Tax amount for the tax type. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "taxName": "A String", # Optional name of the tax type. This should only be provided if `taxType` is `otherFeeTax`. |
| "taxType": "A String", # [required] Type of the tax. Acceptable values are: - "`otherFee`" - "`otherFeeTax`" - "`sales`" |
| }, |
| ], |
| }, |
| }, |
| ], |
| "operationId": "A String", # [required] The ID of the operation, unique across all operations for a given order. |
| "shipmentGroupId": "A String", # [required] ID of the shipment group. It is assigned by the merchant in the `shipLineItems` method and is used to group multiple line items that have the same kind of shipping charges. |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`" |
| "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#orderinvoicesCreateChargeInvoiceResponse". |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="createrefundinvoice">createrefundinvoice(merchantId, orderId, body=None, x__xgafv=None)</code> |
| <pre>Creates a refund invoice for one or more shipment groups, and triggers a refund for orderinvoice enabled orders. This can only be used for line items that have previously been charged using `createChargeInvoice`. All amounts (except for the summary) are incremental with respect to the previous invoice. |
| |
| Args: |
| merchantId: string, The ID of the account that manages the order. This cannot be a multi-client account. (required) |
| orderId: string, The ID of the order. (required) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { |
| "invoiceId": "A String", # [required] The ID of the invoice. |
| "operationId": "A String", # [required] The ID of the operation, unique across all operations for a given order. |
| "refundOnlyOption": { # Option to create a refund-only invoice. Exactly one of `refundOnlyOption` or `returnOption` must be provided. |
| "description": "A String", # Optional description of the refund reason. |
| "reason": "A String", # [required] Reason for the refund. Acceptable values are: - "`adjustment`" - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`courtesyAdjustment`" - "`customerCanceled`" - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`customerSupportRequested`" - "`deliveredLateByCarrier`" - "`deliveredTooLate`" - "`expiredItem`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`feeAdjustment`" - "`invalidCoupon`" - "`lateShipmentCredit`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceAdjustment`" - "`priceError`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`promoReallocation`" - "`qualityNotAsExpected`" - "`returnRefundAbuse`" - "`shippingCostAdjustment`" - "`shippingPriceError`" - "`taxAdjustment`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`" |
| }, |
| "returnOption": { # Option to create an invoice for a refund and mark all items within the invoice as returned. Exactly one of `refundOnlyOption` or `returnOption` must be provided. |
| "description": "A String", # Optional description of the return reason. |
| "reason": "A String", # [required] Reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`" |
| }, |
| "shipmentInvoices": [ # Invoice details for different shipment groups. |
| { |
| "invoiceSummary": { # [required] Invoice summary. |
| "additionalChargeSummaries": [ # Summary of the total amounts of the additional charges. |
| { |
| "totalAmount": { # [required] Total additional charge for this type. |
| "priceAmount": { # [required] The pre-tax or post-tax price depending on the location of the order. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "taxAmount": { # [required] Tax value. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| }, |
| "type": "A String", # [required] Type of the additional charge. Acceptable values are: - "`shipping`" |
| }, |
| ], |
| "productTotal": { # [required] Total price for the product. |
| "priceAmount": { # [required] The pre-tax or post-tax price depending on the location of the order. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "taxAmount": { # [required] Tax value. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| }, |
| }, |
| "lineItemInvoices": [ # [required] Invoice details per line item. |
| { |
| "lineItemId": "A String", # ID of the line item. Either lineItemId or productId must be set. |
| "productId": "A String", # ID of the product. This is the REST ID used in the products service. Either lineItemId or productId must be set. |
| "shipmentUnitIds": [ # [required] The shipment unit ID is assigned by the merchant and defines individual quantities within a line item. The same ID can be assigned to units that are the same while units that differ must be assigned a different ID (for example: free or promotional units). |
| "A String", |
| ], |
| "unitInvoice": { # [required] Invoice details for a single unit. |
| "additionalCharges": [ # Additional charges for a unit, e.g. shipping costs. |
| { |
| "additionalChargeAmount": { # [required] Amount of the additional charge. |
| "priceAmount": { # [required] The pre-tax or post-tax price depending on the location of the order. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "taxAmount": { # [required] Tax value. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| }, |
| "type": "A String", # [required] Type of the additional charge. Acceptable values are: - "`shipping`" |
| }, |
| ], |
| "unitPrice": { # [required] Pre-tax or post-tax price of the unit depending on the locality of the order. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "unitPriceTaxes": [ # Tax amounts to apply to the unit price. |
| { |
| "taxAmount": { # [required] Tax amount for the tax type. |
| "currency": "A String", # The currency of the price. |
| "value": "A String", # The price represented as a number. |
| }, |
| "taxName": "A String", # Optional name of the tax type. This should only be provided if `taxType` is `otherFeeTax`. |
| "taxType": "A String", # [required] Type of the tax. Acceptable values are: - "`otherFee`" - "`otherFeeTax`" - "`sales`" |
| }, |
| ], |
| }, |
| }, |
| ], |
| "shipmentGroupId": "A String", # [required] ID of the shipment group. It is assigned by the merchant in the `shipLineItems` method and is used to group multiple line items that have the same kind of shipping charges. |
| }, |
| ], |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`" |
| "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#orderinvoicesCreateRefundInvoiceResponse". |
| }</pre> |
| </div> |
| |
| </body></html> |