<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.html">Content API for Shopping</a> . <a href="content_v2.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:

{
  &quot;invoiceId&quot;: &quot;A String&quot;, # [required] The ID of the invoice.
  &quot;invoiceSummary&quot;: { # [required] Invoice summary.
    &quot;additionalChargeSummaries&quot;: [ # Summary of the total amounts of the additional charges.
      {
        &quot;totalAmount&quot;: { # [required] Total additional charge for this type.
          &quot;pretax&quot;: { # [required] Value before taxes.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
          &quot;tax&quot;: { # [required] Tax value.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
        },
        &quot;type&quot;: &quot;A String&quot;, # [required] Type of the additional charge. Acceptable values are: - &quot;`shipping`&quot;
      },
    ],
    &quot;customerBalance&quot;: { # Deprecated.
      &quot;pretax&quot;: { # [required] Value before taxes.
        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
      },
      &quot;tax&quot;: { # [required] Tax value.
        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
      },
    },
    &quot;googleBalance&quot;: { # Deprecated.
      &quot;pretax&quot;: { # [required] Value before taxes.
        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
      },
      &quot;tax&quot;: { # [required] Tax value.
        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
      },
    },
    &quot;merchantBalance&quot;: { # Deprecated.
      &quot;pretax&quot;: { # [required] Value before taxes.
        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
      },
      &quot;tax&quot;: { # [required] Tax value.
        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
      },
    },
    &quot;productTotal&quot;: { # [required] Total price for the product.
      &quot;pretax&quot;: { # [required] Value before taxes.
        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
      },
      &quot;tax&quot;: { # [required] Tax value.
        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
      },
    },
    &quot;promotionSummaries&quot;: [ # Deprecated.
      {
        &quot;promotionAmount&quot;: { # [required] Amount of the promotion. The values here are the promotion applied to the unit price pretax and to the total of the tax amounts.
          &quot;pretax&quot;: { # [required] Value before taxes.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
          &quot;tax&quot;: { # [required] Tax value.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
        },
        &quot;promotionId&quot;: &quot;A String&quot;, # [required] ID of the promotion.
      },
    ],
  },
  &quot;lineItemInvoices&quot;: [ # [required] Invoice details per line item.
    {
      &quot;lineItemId&quot;: &quot;A String&quot;, # ID of the line item. Either lineItemId or productId must be set.
      &quot;productId&quot;: &quot;A String&quot;, # ID of the product. This is the REST ID used in the products service. Either lineItemId or productId must be set.
      &quot;shipmentUnitIds&quot;: [ # [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).
        &quot;A String&quot;,
      ],
      &quot;unitInvoice&quot;: { # [required] Invoice details for a single unit.
        &quot;additionalCharges&quot;: [ # Additional charges for a unit, e.g. shipping costs.
          {
            &quot;additionalChargeAmount&quot;: { # [required] Amount of the additional charge.
              &quot;pretax&quot;: { # [required] Value before taxes.
                &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
              },
              &quot;tax&quot;: { # [required] Tax value.
                &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
              },
            },
            &quot;additionalChargePromotions&quot;: [ # Deprecated.
              {
                &quot;promotionAmount&quot;: { # [required] Amount of the promotion. The values here are the promotion applied to the unit price pretax and to the total of the tax amounts.
                  &quot;pretax&quot;: { # [required] Value before taxes.
                    &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                    &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                  },
                  &quot;tax&quot;: { # [required] Tax value.
                    &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                    &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                  },
                },
                &quot;promotionId&quot;: &quot;A String&quot;, # [required] ID of the promotion.
              },
            ],
            &quot;type&quot;: &quot;A String&quot;, # [required] Type of the additional charge. Acceptable values are: - &quot;`shipping`&quot;
          },
        ],
        &quot;promotions&quot;: [ # Deprecated.
          {
            &quot;promotionAmount&quot;: { # [required] Amount of the promotion. The values here are the promotion applied to the unit price pretax and to the total of the tax amounts.
              &quot;pretax&quot;: { # [required] Value before taxes.
                &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
              },
              &quot;tax&quot;: { # [required] Tax value.
                &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
              },
            },
            &quot;promotionId&quot;: &quot;A String&quot;, # [required] ID of the promotion.
          },
        ],
        &quot;unitPricePretax&quot;: { # [required] Price of the unit, before applying taxes.
          &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
          &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
        },
        &quot;unitPriceTaxes&quot;: [ # Tax amounts to apply to the unit price.
          {
            &quot;taxAmount&quot;: { # [required] Tax amount for the tax type.
              &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
              &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
            },
            &quot;taxName&quot;: &quot;A String&quot;, # Optional name of the tax type. This should only be provided if `taxType` is `otherFeeTax`.
            &quot;taxType&quot;: &quot;A String&quot;, # [required] Type of the tax. Acceptable values are: - &quot;`otherFee`&quot; - &quot;`otherFeeTax`&quot; - &quot;`sales`&quot;
          },
        ],
      },
    },
  ],
  &quot;operationId&quot;: &quot;A String&quot;, # [required] The ID of the operation, unique across all operations for a given order.
  &quot;shipmentGroupId&quot;: &quot;A String&quot;, # [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:

    {
  &quot;executionStatus&quot;: &quot;A String&quot;, # The status of the execution. Acceptable values are: - &quot;`duplicate`&quot; - &quot;`executed`&quot;
  &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;content#orderinvoicesCreateChargeInvoiceResponse&quot;.
}</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:

{
  &quot;invoiceId&quot;: &quot;A String&quot;, # [required] The ID of the invoice.
  &quot;operationId&quot;: &quot;A String&quot;, # [required] The ID of the operation, unique across all operations for a given order.
  &quot;refundOnlyOption&quot;: { # Option to create a refund-only invoice. Exactly one of `refundOnlyOption` or `returnOption` must be provided.
    &quot;description&quot;: &quot;A String&quot;, # Optional description of the refund reason.
    &quot;reason&quot;: &quot;A String&quot;, # [required] Reason for the refund. Acceptable values are: - &quot;`adjustment`&quot; - &quot;`autoPostInternal`&quot; - &quot;`autoPostInvalidBillingAddress`&quot; - &quot;`autoPostNoInventory`&quot; - &quot;`autoPostPriceError`&quot; - &quot;`autoPostUndeliverableShippingAddress`&quot; - &quot;`couponAbuse`&quot; - &quot;`courtesyAdjustment`&quot; - &quot;`customerCanceled`&quot; - &quot;`customerDiscretionaryReturn`&quot; - &quot;`customerInitiatedMerchantCancel`&quot; - &quot;`customerSupportRequested`&quot; - &quot;`deliveredLateByCarrier`&quot; - &quot;`deliveredTooLate`&quot; - &quot;`expiredItem`&quot; - &quot;`failToPushOrderGoogleError`&quot; - &quot;`failToPushOrderMerchantError`&quot; - &quot;`failToPushOrderMerchantFulfillmentError`&quot; - &quot;`failToPushOrderToMerchant`&quot; - &quot;`failToPushOrderToMerchantOutOfStock`&quot; - &quot;`feeAdjustment`&quot; - &quot;`invalidCoupon`&quot; - &quot;`lateShipmentCredit`&quot; - &quot;`malformedShippingAddress`&quot; - &quot;`merchantDidNotShipOnTime`&quot; - &quot;`noInventory`&quot; - &quot;`orderTimeout`&quot; - &quot;`other`&quot; - &quot;`paymentAbuse`&quot; - &quot;`paymentDeclined`&quot; - &quot;`priceAdjustment`&quot; - &quot;`priceError`&quot; - &quot;`productArrivedDamaged`&quot; - &quot;`productNotAsDescribed`&quot; - &quot;`promoReallocation`&quot; - &quot;`qualityNotAsExpected`&quot; - &quot;`returnRefundAbuse`&quot; - &quot;`shippingCostAdjustment`&quot; - &quot;`shippingPriceError`&quot; - &quot;`taxAdjustment`&quot; - &quot;`taxError`&quot; - &quot;`undeliverableShippingAddress`&quot; - &quot;`unsupportedPoBoxAddress`&quot; - &quot;`wrongProductShipped`&quot;
  },
  &quot;returnOption&quot;: { # 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.
    &quot;description&quot;: &quot;A String&quot;, # Optional description of the return reason.
    &quot;reason&quot;: &quot;A String&quot;, # [required] Reason for the return. Acceptable values are: - &quot;`customerDiscretionaryReturn`&quot; - &quot;`customerInitiatedMerchantCancel`&quot; - &quot;`deliveredTooLate`&quot; - &quot;`expiredItem`&quot; - &quot;`invalidCoupon`&quot; - &quot;`malformedShippingAddress`&quot; - &quot;`other`&quot; - &quot;`productArrivedDamaged`&quot; - &quot;`productNotAsDescribed`&quot; - &quot;`qualityNotAsExpected`&quot; - &quot;`undeliverableShippingAddress`&quot; - &quot;`unsupportedPoBoxAddress`&quot; - &quot;`wrongProductShipped`&quot;
  },
  &quot;shipmentInvoices&quot;: [ # Invoice details for different shipment groups.
    {
      &quot;invoiceSummary&quot;: { # [required] Invoice summary.
        &quot;additionalChargeSummaries&quot;: [ # Summary of the total amounts of the additional charges.
          {
            &quot;totalAmount&quot;: { # [required] Total additional charge for this type.
              &quot;pretax&quot;: { # [required] Value before taxes.
                &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
              },
              &quot;tax&quot;: { # [required] Tax value.
                &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
              },
            },
            &quot;type&quot;: &quot;A String&quot;, # [required] Type of the additional charge. Acceptable values are: - &quot;`shipping`&quot;
          },
        ],
        &quot;customerBalance&quot;: { # Deprecated.
          &quot;pretax&quot;: { # [required] Value before taxes.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
          &quot;tax&quot;: { # [required] Tax value.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
        },
        &quot;googleBalance&quot;: { # Deprecated.
          &quot;pretax&quot;: { # [required] Value before taxes.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
          &quot;tax&quot;: { # [required] Tax value.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
        },
        &quot;merchantBalance&quot;: { # Deprecated.
          &quot;pretax&quot;: { # [required] Value before taxes.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
          &quot;tax&quot;: { # [required] Tax value.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
        },
        &quot;productTotal&quot;: { # [required] Total price for the product.
          &quot;pretax&quot;: { # [required] Value before taxes.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
          &quot;tax&quot;: { # [required] Tax value.
            &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
            &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
          },
        },
        &quot;promotionSummaries&quot;: [ # Deprecated.
          {
            &quot;promotionAmount&quot;: { # [required] Amount of the promotion. The values here are the promotion applied to the unit price pretax and to the total of the tax amounts.
              &quot;pretax&quot;: { # [required] Value before taxes.
                &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
              },
              &quot;tax&quot;: { # [required] Tax value.
                &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
              },
            },
            &quot;promotionId&quot;: &quot;A String&quot;, # [required] ID of the promotion.
          },
        ],
      },
      &quot;lineItemInvoices&quot;: [ # [required] Invoice details per line item.
        {
          &quot;lineItemId&quot;: &quot;A String&quot;, # ID of the line item. Either lineItemId or productId must be set.
          &quot;productId&quot;: &quot;A String&quot;, # ID of the product. This is the REST ID used in the products service. Either lineItemId or productId must be set.
          &quot;shipmentUnitIds&quot;: [ # [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).
            &quot;A String&quot;,
          ],
          &quot;unitInvoice&quot;: { # [required] Invoice details for a single unit.
            &quot;additionalCharges&quot;: [ # Additional charges for a unit, e.g. shipping costs.
              {
                &quot;additionalChargeAmount&quot;: { # [required] Amount of the additional charge.
                  &quot;pretax&quot;: { # [required] Value before taxes.
                    &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                    &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                  },
                  &quot;tax&quot;: { # [required] Tax value.
                    &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                    &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                  },
                },
                &quot;additionalChargePromotions&quot;: [ # Deprecated.
                  {
                    &quot;promotionAmount&quot;: { # [required] Amount of the promotion. The values here are the promotion applied to the unit price pretax and to the total of the tax amounts.
                      &quot;pretax&quot;: { # [required] Value before taxes.
                        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                      },
                      &quot;tax&quot;: { # [required] Tax value.
                        &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                        &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                      },
                    },
                    &quot;promotionId&quot;: &quot;A String&quot;, # [required] ID of the promotion.
                  },
                ],
                &quot;type&quot;: &quot;A String&quot;, # [required] Type of the additional charge. Acceptable values are: - &quot;`shipping`&quot;
              },
            ],
            &quot;promotions&quot;: [ # Deprecated.
              {
                &quot;promotionAmount&quot;: { # [required] Amount of the promotion. The values here are the promotion applied to the unit price pretax and to the total of the tax amounts.
                  &quot;pretax&quot;: { # [required] Value before taxes.
                    &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                    &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                  },
                  &quot;tax&quot;: { # [required] Tax value.
                    &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                    &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                  },
                },
                &quot;promotionId&quot;: &quot;A String&quot;, # [required] ID of the promotion.
              },
            ],
            &quot;unitPricePretax&quot;: { # [required] Price of the unit, before applying taxes.
              &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
              &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
            },
            &quot;unitPriceTaxes&quot;: [ # Tax amounts to apply to the unit price.
              {
                &quot;taxAmount&quot;: { # [required] Tax amount for the tax type.
                  &quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
                  &quot;value&quot;: &quot;A String&quot;, # The price represented as a number.
                },
                &quot;taxName&quot;: &quot;A String&quot;, # Optional name of the tax type. This should only be provided if `taxType` is `otherFeeTax`.
                &quot;taxType&quot;: &quot;A String&quot;, # [required] Type of the tax. Acceptable values are: - &quot;`otherFee`&quot; - &quot;`otherFeeTax`&quot; - &quot;`sales`&quot;
              },
            ],
          },
        },
      ],
      &quot;shipmentGroupId&quot;: &quot;A String&quot;, # [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:

    {
  &quot;executionStatus&quot;: &quot;A String&quot;, # The status of the execution. Acceptable values are: - &quot;`duplicate`&quot; - &quot;`executed`&quot;
  &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;content#orderinvoicesCreateRefundInvoiceResponse&quot;.
}</pre>
</div>

</body></html>