Method: customers.invoices.list

string

Bắt buộc. Mã của khách hàng để tìm nạp hoá đơn.

string

Bắt buộc. Tên tài nguyên thông tin thanh toán của các hóa đơn được yêu cầu.

customers/{customerId}/billingSetups/{billing_setup_id}

string

Bắt buộc. Năm phát hành để truy xuất hoá đơn, ở định dạng yyyy. Bạn chỉ có thể truy xuất các hoá đơn được phát hành trong năm 2019 trở đi.

enum (MonthOfYear)

Bắt buộc. Tháng phát hành để truy xuất hoá đơn.

{
  "resourceName": string,
  "type": enum (InvoiceType),
  "serviceDateRange": {
    object (DateRange)
  },
  "adjustmentsSubtotalAmountMicros": string,
  "adjustmentsTaxAmountMicros": string,
  "adjustmentsTotalAmountMicros": string,
  "regulatoryCostsSubtotalAmountMicros": string,
  "regulatoryCostsTaxAmountMicros": string,
  "regulatoryCostsTotalAmountMicros": string,
  "replacedInvoices": [
    string
  ],
  "accountBudgetSummaries": [
    {
      object (AccountBudgetSummary)
    }
  ],
  "accountSummaries": [
    {
      object (AccountSummary)
    }
  ],
  "id": string,
  "billingSetup": string,
  "paymentsAccountId": string,
  "paymentsProfileId": string,
  "issueDate": string,
  "dueDate": string,
  "currencyCode": string,
  "exportChargeSubtotalAmountMicros": string,
  "exportChargeTaxAmountMicros": string,
  "exportChargeTotalAmountMicros": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string,
  "correctedInvoice": string,
  "pdfUrl": string
}

string

Chỉ có đầu ra. Tên tài nguyên của hoá đơn. Nhiều khách hàng có thể dùng chung một hoá đơn nhất định, vì vậy, nhiều tên tài nguyên có thể trỏ đến cùng một hoá đơn. Tên nguồn tài nguyên trên hoá đơn có dạng:

customers/{customerId}/invoices/{invoice_id}

enum (InvoiceType)

Chỉ có đầu ra. Loại hoá đơn.

object (DateRange)

Chỉ có đầu ra. Phạm vi ngày sử dụng dịch vụ của hoá đơn này. Ngày kết thúc có tính toàn bộ.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền phụ trước thuế của các khoản điều chỉnh ở cấp hoá đơn, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng thuế trên các mức điều chỉnh cấp hoá đơn, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền điều chỉnh cấp hoá đơn, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền phụ trước thuế của các chi phí theo quy định ở cấp hoá đơn, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng thuế đối với chi phí theo quy định ở cấp hoá đơn, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng chi phí theo quy định ở cấp hoá đơn, tính bằng phần triệu.

string

Chỉ có đầu ra. Tên tài nguyên của(các) hoá đơn gốc đang được lập lại hoặc thay thế bằng hoá đơn này, nếu có. Có thể có nhiều hoá đơn được thay thế do việc hợp nhất hoá đơn. Các hoá đơn được thay thế có thể không thuộc về cùng một tài khoản thanh toán. Nếu bạn đặt replacedInvoices, correctedInvoice sẽ không được đặt. Tên nguồn tài nguyên trên hoá đơn có dạng:

customers/{customerId}/invoices/{invoice_id}

object (AccountBudgetSummary)

Chỉ có đầu ra. Danh sách thông tin tóm tắt về ngân sách tài khoản liên quan đến hoá đơn này.

object (AccountSummary)

Chỉ có đầu ra. Danh sách thông tin tài khoản tóm tắt liên quan đến hoá đơn này.

string

Chỉ có đầu ra. Mã hoá đơn. Số này xuất hiện trên bản PDF của hoá đơn dưới dạng "Số hoá đơn".

string

Chỉ có đầu ra. Tên tài nguyên của thông tin thanh toán của hóa đơn này.

customers/{customerId}/billingSetups/{billing_setup_id}

string

Chỉ có đầu ra. Mã gồm 16 chữ số được dùng để xác định tài khoản thanh toán được liên kết với thông tin thanh toán, ví dụ: "1234-5678-9012-3456". Số này xuất hiện trên hoá đơn PDF dưới dạng "Số tài khoản thanh toán".

string

Chỉ có đầu ra. Mã gồm 12 chữ số được dùng để xác định hồ sơ thanh toán được liên kết với thông tin thanh toán, ví dụ: "1234-5678-9012". Mã này xuất hiện trên hoá đơn PDF dưới dạng "Mã thanh toán".

string

Chỉ có đầu ra. Ngày phát hành ở định dạng yyyy-mm-dd. Ngày này xuất hiện trên hoá đơn PDF dưới dạng "Ngày phát hành" hoặc "Ngày lập hoá đơn".

string

Chỉ có đầu ra. Ngày đến hạn có định dạng yyyy-mm-dd.

string

Chỉ có đầu ra. Mã đơn vị tiền tệ. Tất cả chi phí đều được trả về bằng đơn vị tiền tệ này. Một số mã đơn vị tiền tệ bắt nguồn từ tiêu chuẩn ISO 4217 sẽ được hỗ trợ.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền phụ trước thuế của phí xuất khẩu ở cấp hoá đơn, tính bằng micro giây.

string (int64 format)

Chỉ có đầu ra. Tổng thuế đối với phí xuất khẩu ở cấp hoá đơn, tính theo phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền phí xuất khẩu ở cấp hoá đơn, tính theo phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền trước thuế, tính bằng phần triệu. Số tiền này bằng tổng số tiền của tổng số tiền AccountBudgetsummary và hoá đơn.điều chỉnh_subtotal_amount_micros.

string (int64 format)

Chỉ có đầu ra. Tổng tất cả các khoản thuế trên hoá đơn, tính bằng phần triệu. Số tiền này bằng tổng số tiền thuế AccountBudgetsummary, cộng với các khoản thuế không liên quan đến một ngân sách tài khoản cụ thể.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền, tính bằng phần triệu. Số tiền này bằng tổng của Bill.subtotal_amount_micros, Bill.tax_amount_micros, Bill.regulatory_costs_subtotal_amount_micros và Bill.export_charge_subtotal_amount_micros (được tách riêng thành một mục riêng bắt đầu từ phiên bản V14.1).

string

Chỉ có đầu ra. Tên tài nguyên của hóa đơn gốc đã được sửa đổi, xóa sổ hoặc hủy bởi hóa đơn này, nếu có. Nếu bạn đặt correctedInvoice, replacedInvoices sẽ không được đặt. Tên nguồn tài nguyên trên hoá đơn có dạng:

customers/{customerId}/invoices/{invoice_id}

string

Chỉ có đầu ra. URL đến bản sao PDF của hoá đơn. Người dùng cần chuyển mã thông báo OAuth của họ để yêu cầu tệp PDF bằng URL này.

{
  "billableActivityDateRange": {
    object (DateRange)
  },
  "invalidActivitySummaries": [
    {
      object (InvalidActivitySummary)
    }
  ],
  "customer": string,
  "customerDescriptiveName": string,
  "accountBudget": string,
  "accountBudgetName": string,
  "purchaseOrderNumber": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string,
  "servedAmountMicros": string,
  "billedAmountMicros": string,
  "overdeliveryAmountMicros": string,
  "invalidActivityAmountMicros": string
}

object (DateRange)

Chỉ có đầu ra. Phạm vi ngày của hoạt động có thể lập hoá đơn của ngân sách tài khoản, nằm trong phạm vi ngày sử dụng dịch vụ của hoá đơn này. Ngày kết thúc có tính toàn bộ. Thời gian này có thể khác với thời gian bắt đầu và kết thúc của ngân sách tài khoản.

object (InvalidActivitySummary)

Chỉ có đầu ra. Danh sách tóm tắt các khoản tín dụng cho hoạt động không hợp lệ kèm theo các mối liên kết ban đầu.

string

Chỉ có đầu ra. Tên tài nguyên của khách hàng được liên kết với ngân sách tài khoản này. Mã này chứa mã khách hàng xuất hiện trên hoá đơn dạng PDF dưới dạng "Mã tài khoản". Tên tài nguyên dành cho khách hàng có dạng:

customers/{customerId}

string

Chỉ có đầu ra. Tên mô tả của khách hàng trong ngân sách tài khoản. Tài khoản này xuất hiện trên hoá đơn PDF dưới dạng "Tài khoản".

string

Chỉ có đầu ra. Tên tài nguyên của ngân sách tài khoản liên quan đến chi phí có thể lập hoá đơn tóm tắt này. Tên tài nguyên AccountBudget có dạng:

customers/{customerId}/accountBudgets/{account_budget_id}

string

Chỉ có đầu ra. Tên ngân sách tài khoản. Ngân sách này xuất hiện trên hoá đơn PDF dưới dạng "Ngân sách tài khoản".

string

Chỉ có đầu ra. Số đơn đặt hàng của ngân sách tài khoản. Khoản phí này xuất hiện trên hoá đơn dạng PDF dưới dạng "Đơn đặt hàng".

string (int64 format)

Chỉ có đầu ra. Số tiền tổng phụ trước thuế được phân bổ cho ngân sách này trong thời gian dịch vụ, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Số tiền thuế được phân bổ cho ngân sách này trong thời gian dịch vụ, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền được phân bổ cho ngân sách này trong thời gian dịch vụ, tính bằng phần triệu. Giá trị này bằng tổng của tổng chi phí (dưới dạng ngân sách tài khoản) và số tiền thuế trong ngân sách tài khoản.

string (int64 format)

Chỉ có đầu ra. Số tiền phân phát trước thuế có thể phân bổ cho ngân sách này trong thời gian dịch vụ, tính bằng phần triệu. Việc này chỉ hữu ích để điều chỉnh dữ liệu hoá đơn và giao hàng.

string (int64 format)

Chỉ có đầu ra. Số tiền đã lập hoá đơn trước thuế được phân bổ cho ngân sách này trong thời gian sử dụng dịch vụ, tính bằng phần triệu. Quá trình này không tính đến bất kỳ sự điều chỉnh nào.

string (int64 format)

Chỉ có đầu ra. Số tiền phân phối quá trước thuế có thể được phân bổ cho ngân sách này trong thời gian dịch vụ, tính bằng micro (giá trị âm).

string (int64 format)

Chỉ có đầu ra. Số tiền hoạt động không hợp lệ trước thuế có thể được phân bổ cho ngân sách này trong những tháng trước, tính bằng phần triệu (giá trị âm).

{
  "originalMonthOfService": enum (MonthOfYear),
  "originalYearOfService": string,
  "originalInvoiceId": string,
  "originalAccountBudgetName": string,
  "originalPurchaseOrderNumber": string,
  "amountMicros": string
}

enum (MonthOfYear)

Chỉ có đầu ra. Tháng sử dụng dịch vụ ban đầu có liên quan đến khoản tín dụng cho hoạt động không hợp lệ này.

string

Chỉ có đầu ra. Năm sử dụng dịch vụ gốc có liên quan đến khoản tín dụng cho hoạt động không hợp lệ này.

string

Chỉ có đầu ra. Số hoá đơn ban đầu liên quan đến khoản tín dụng cho hoạt động không hợp lệ này.

string

Chỉ có đầu ra. Tên ngân sách tài khoản ban đầu có liên quan đến khoản tín dụng cho hoạt động không hợp lệ này.

string

Chỉ có đầu ra. Số đơn đặt hàng ban đầu có liên quan đến khoản tín dụng cho hoạt động không hợp lệ này.

string (int64 format)

Chỉ có đầu ra. Lượng hoạt động không hợp lệ tính bằng phần triệu.

{
  "customer": string,
  "billingCorrectionSubtotalAmountMicros": string,
  "billingCorrectionTaxAmountMicros": string,
  "billingCorrectionTotalAmountMicros": string,
  "couponAdjustmentSubtotalAmountMicros": string,
  "couponAdjustmentTaxAmountMicros": string,
  "couponAdjustmentTotalAmountMicros": string,
  "excessCreditAdjustmentSubtotalAmountMicros": string,
  "excessCreditAdjustmentTaxAmountMicros": string,
  "excessCreditAdjustmentTotalAmountMicros": string,
  "regulatoryCostsSubtotalAmountMicros": string,
  "regulatoryCostsTaxAmountMicros": string,
  "regulatoryCostsTotalAmountMicros": string,
  "exportChargeSubtotalAmountMicros": string,
  "exportChargeTaxAmountMicros": string,
  "exportChargeTotalAmountMicros": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string
}

string

Chỉ có đầu ra. Tài khoản được liên kết với phần tóm tắt về tài khoản.

string (int64 format)

Chỉ có đầu ra. Tổng số phụ của khoản điều chỉnh thanh toán trước thuế, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Thuế điều chỉnh khoản thanh toán, tính theo phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền điều chỉnh thanh toán, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền điều chỉnh của phiếu giảm giá trước thuế, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Thuế điều chỉnh phiếu giảm giá, tính theo phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền điều chỉnh phiếu giảm giá, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền điều chỉnh tín dụng dư trước thuế, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Thuế đối với khoản điều chỉnh tín dụng dư thừa, tính theo phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền điều chỉnh tín dụng dư thừa, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng chi phí theo quy định trước thuế là tổng số tiền, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Thuế đối với chi phí theo quy định, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền chi phí theo quy định, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền cho phí xuất khẩu trước thuế, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Thuế tính trên phí xuất khẩu, tính theo phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền phí xuất, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền phụ trước thuế có thể phân bổ cho tài khoản trong thời gian dịch vụ, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền thuế có thể quy cho tài khoản trong thời gian dịch vụ, tính bằng phần triệu.

string (int64 format)

Chỉ có đầu ra. Tổng số tiền có thể phân bổ cho tài khoản trong thời gian dịch vụ, tính theo phần triệu. Số tiền này bằng tổng của subtotalAmountMicros và taxAmountMicros.