Schedule Pro Services Invoice

Schedule ProService invoice

client.V1.Contracts.ScheduleProServicesInvoice(ctx, body) (*, error)

post/v1/contracts/scheduleProServicesInvoice

Create a new scheduled invoice for Professional Services terms on a contract. This endpoint's availability is dependent on your client's configuration.

Parameters

body

Hide ParametersShow Parameters

ContractIDfield

param.Field[string]

formatuuid

CustomerIDfield

param.Field[string]

formatuuid

IssuedAtfield

param.Field[Time]

The date the invoice is issued

formatdate-time

LineItemsfield

param.Field[[]V1ContractScheduleProServicesInvoiceParamsLineItem]

Each line requires an amount or both unit_price and quantity.

Hide ParametersShow Parameters

ProfessionalServiceIDstring

formatuuid

AmendmentIDstring

optional

If the professional_service_id was added on an amendment, this is required.

formatuuid

Amountfloat64

optional

Amount for the term on the new invoice.

Metadatastring

optional

For client use.

NetsuiteInvoiceBillingEndTime

optional

The end date for the billing period on the invoice.

formatdate-time

NetsuiteInvoiceBillingStartTime

optional

The start date for the billing period on the invoice.

formatdate-time

Quantityfloat64

optional

Quantity for the charge. Will be multiplied by unit_price to determine the amount.

UnitPricefloat64

optional

If specified, this overrides the unit price on the pro service term. Must also provide quantity (but not amount) if providing unit_price.

NetsuiteInvoiceHeaderEndfield

optional

param.Field[Time]

The end date of the invoice header in Netsuite

formatdate-time

NetsuiteInvoiceHeaderStartfield

optional

param.Field[Time]

The start date of the invoice header in Netsuite

formatdate-time

Returns

V1ContractScheduleProServicesInvoiceResponsestruct

Hide ParametersShow Parameters

Dataarray

[]

Hide ParametersShow Parameters

IDstring

formatuuid

CreditType

CustomerIDstring

formatuuid

LineItemsarray

[]InvoiceLineItem

Hide ParametersShow Parameters

CreditType

Namestring

Totalfloat64

AppliedCommitOrCredit

optional

Details about the credit or commit that was applied to this line item. Only present on line items with product of USAGE, SUBSCRIPTION or COMPOSITE types.

Hide ParametersShow Parameters

IDstring

formatuuid

Type

Hide ParametersShow Parameters

InvoiceLineItemsAppliedCommitOrCreditTypePrepaidconst

"PREPAID"

InvoiceLineItemsAppliedCommitOrCreditTypePostpaidconst

"POSTPAID"

InvoiceLineItemsAppliedCommitOrCreditTypeCreditconst

"CREDIT"

CommitCustomFieldsmap

optional

map[string, string]

CommitIDstring

optional

For line items with product of USAGE, SUBSCRIPTION, or COMPOSITE types, the ID of the credit or commit that was applied to this line item. For line items with product type of FIXED, the ID of the prepaid or postpaid commit that is being paid for.

formatuuid

CommitNetsuiteItemIDstring

optional

CommitNetsuiteSalesOrderIDstring

optional

CommitSegmentIDstring

optional

formatuuid

CommitTypestring

optional

PrepaidCommit (for commit types PREPAID and CREDIT) or PostpaidCommit (for commit type POSTPAID).

CustomFieldsmap

optional

map[string, string]

DiscountCustomFieldsmap

optional

map[string, string]

DiscountIDstring

optional

ID of the discount applied to this line item.

formatuuid

EndingBeforeTime

optional

The line item's end date (exclusive).

formatdate-time

GroupKeystring

optional

GroupValuestring

optional

IsProratedbool

optional

Indicates whether the line item is prorated for SUBSCRIPTION type product.

ListPrice

optional

Only present for contract invoices and when the include_list_prices query parameter is set to true. This will include the list rate for the charge if applicable. Only present for usage and subscription line items.

Metadatastring

optional

NetsuiteInvoiceBillingEndTime

optional

The end date for the billing period on the invoice.

formatdate-time

NetsuiteInvoiceBillingStartTime

optional

The start date for the billing period on the invoice.

formatdate-time

NetsuiteItemIDstring

optional

PostpaidCommit

optional

Only present for line items paying for a postpaid commit true-up.

Hide ParametersShow Parameters

IDstring

formatuuid

PresentationGroupValuesmap

optional

map[string, string]

Includes the presentation group values associated with this line item if presentation group keys are used.

PricingGroupValuesmap

optional

map[string, string]

Includes the pricing group values associated with this line item if dimensional pricing is used.

ProductCustomFieldsmap

optional

map[string, string]

ProductIDstring

optional

ID of the product associated with the line item.

formatuuid

ProductTagsarray

optional

[]string

The current product tags associated with the line item's product_id.

ProductTypestring

optional

The type of the line item's product. Possible values are FixedProductListItem (for FIXED type products), UsageProductListItem (for USAGE type products), SubscriptionProductListItem (for SUBSCRIPTION type products) or CompositeProductListItem (for COMPOSITE type products). For scheduled charges, commit and credit payments, the value is FixedProductListItem.

ProfessionalServiceCustomFieldsmap

optional

map[string, string]

ProfessionalServiceIDstring

optional

formatuuid

Quantityfloat64

optional

The quantity associated with the line item.

ResellerType

optional

Hide ParametersShow Parameters

InvoiceLineItemsResellerTypeAwsconst

"AWS"

InvoiceLineItemsResellerTypeAwsProServiceconst

"AWS_PRO_SERVICE"

InvoiceLineItemsResellerTypeGcpconst

"GCP"

InvoiceLineItemsResellerTypeGcpProServiceconst

"GCP_PRO_SERVICE"

ScheduledChargeCustomFieldsmap

optional

map[string, string]

ScheduledChargeIDstring

optional

ID of scheduled charge.

formatuuid

StartingAtTime

optional

The line item's start date (inclusive).

formatdate-time

SubLineItemsarray

optional

[]InvoiceLineItemsSubLineItem

Hide ParametersShow Parameters

CustomFieldsmap

map[string, string]

Namestring

Quantityfloat64

Subtotalfloat64

ChargeIDstring

optional

formatuuid

CreditGrantIDstring

optional

formatuuid

EndDateTime

optional

The end date for the charge (for seats charges only).

formatdate-time

Pricefloat64

optional

the unit price for this charge, present only if the charge is not tiered and the quantity is nonzero

StartDateTime

optional

The start date for the charge (for seats charges only).

formatdate-time

TierPeriod

optional

when the current tier started and ends (for tiered charges only)

Hide ParametersShow Parameters

StartingAtTime

formatdate-time

EndingBeforeTime

optional

formatdate-time

Tiersarray

optional

[]InvoiceLineItemsSubLineItemsTier

Hide ParametersShow Parameters

Pricefloat64

Quantityfloat64

StartingAtfloat64

at what metric amount this tier begins

Subtotalfloat64

SubscriptionCustomFieldsmap

optional

map[string, string]

Tier

optional

Populated if the line item has a tiered price.

Hide ParametersShow Parameters

Levelfloat64

StartingAtstring

Sizestring

optional

UnitPricefloat64

optional

The unit price associated with the line item.

Statusstring

Totalfloat64

Typestring

AmendmentIDstring

optional

formatuuid

BillableStatus

optional

This field's availability is dependent on your client's configuration.

Hide ParametersShow Parameters

InvoiceBillableStatusBillableconst

"billable"

InvoiceBillableStatusUnbillableconst

"unbillable"

ContractCustomFieldsmap

optional

map[string, string]

ContractIDstring

optional

formatuuid

CorrectionRecord

optional

Hide ParametersShow Parameters

CorrectedInvoiceIDstring

formatuuid

Memostring

Reasonstring

CorrectedExternalInvoice

optional

Hide ParametersShow Parameters

BillingProviderType

Hide ParametersShow Parameters

InvoiceCorrectionRecordCorrectedExternalInvoiceBillingProviderTypeAwsMarketplaceconst

"aws_marketplace"

InvoiceCorrectionRecordCorrectedExternalInvoiceBillingProviderTypeStripeconst

"stripe"

InvoiceCorrectionRecordCorrectedExternalInvoiceBillingProviderTypeNetsuiteconst

"netsuite"

InvoiceCorrectionRecordCorrectedExternalInvoiceBillingProviderTypeCustomconst

"custom"

InvoiceCorrectionRecordCorrectedExternalInvoiceBillingProviderTypeAzureMarketplaceconst

"azure_marketplace"

InvoiceCorrectionRecordCorrectedExternalInvoiceBillingProviderTypeQuickbooksOnlineconst

"quickbooks_online"

InvoiceCorrectionRecordCorrectedExternalInvoiceBillingProviderTypeWorkdayconst

"workday"

InvoiceCorrectionRecordCorrectedExternalInvoiceBillingProviderTypeGcpMarketplaceconst

"gcp_marketplace"

ExternalStatus

optional

Hide ParametersShow Parameters

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusDraftconst

"DRAFT"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusFinalizedconst

"FINALIZED"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusPaidconst

"PAID"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusUncollectibleconst

"UNCOLLECTIBLE"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusVoidconst

"VOID"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusDeletedconst

"DELETED"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusPaymentFailedconst

"PAYMENT_FAILED"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusInvalidRequestErrorconst

"INVALID_REQUEST_ERROR"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusSkippedconst

"SKIPPED"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusSentconst

"SENT"

InvoiceCorrectionRecordCorrectedExternalInvoiceExternalStatusQueuedconst

"QUEUED"

InvoiceIDstring

optional

IssuedAtTimestampTime

optional

formatdate-time

CreatedAtTime

optional

When the invoice was created (UTC). This field is present for correction invoices only.

formatdate-time

CustomFieldsmap

optional

map[string, unknown]

CustomerCustomFieldsmap

optional

map[string, string]

EndTimestampTime

optional

End of the usage period this invoice covers (UTC)

formatdate-time

ExternalInvoice

optional

Hide ParametersShow Parameters

BillingProviderType

Hide ParametersShow Parameters

InvoiceExternalInvoiceBillingProviderTypeAwsMarketplaceconst

"aws_marketplace"

InvoiceExternalInvoiceBillingProviderTypeStripeconst

"stripe"

InvoiceExternalInvoiceBillingProviderTypeNetsuiteconst

"netsuite"

InvoiceExternalInvoiceBillingProviderTypeCustomconst

"custom"

InvoiceExternalInvoiceBillingProviderTypeAzureMarketplaceconst

"azure_marketplace"

InvoiceExternalInvoiceBillingProviderTypeQuickbooksOnlineconst

"quickbooks_online"

InvoiceExternalInvoiceBillingProviderTypeWorkdayconst

"workday"

InvoiceExternalInvoiceBillingProviderTypeGcpMarketplaceconst

"gcp_marketplace"

ExternalStatus

optional

Hide ParametersShow Parameters

InvoiceExternalInvoiceExternalStatusDraftconst

"DRAFT"

InvoiceExternalInvoiceExternalStatusFinalizedconst

"FINALIZED"

InvoiceExternalInvoiceExternalStatusPaidconst

"PAID"

InvoiceExternalInvoiceExternalStatusUncollectibleconst

"UNCOLLECTIBLE"

InvoiceExternalInvoiceExternalStatusVoidconst

"VOID"

InvoiceExternalInvoiceExternalStatusDeletedconst

"DELETED"

InvoiceExternalInvoiceExternalStatusPaymentFailedconst

"PAYMENT_FAILED"

InvoiceExternalInvoiceExternalStatusInvalidRequestErrorconst

"INVALID_REQUEST_ERROR"

InvoiceExternalInvoiceExternalStatusSkippedconst

"SKIPPED"

InvoiceExternalInvoiceExternalStatusSentconst

"SENT"

InvoiceExternalInvoiceExternalStatusQueuedconst

"QUEUED"

InvoiceIDstring

optional

IssuedAtTimestampTime

optional

formatdate-time

InvoiceAdjustmentsarray

optional

[]InvoiceInvoiceAdjustment

Hide ParametersShow Parameters

CreditType

Namestring

Totalfloat64

CreditGrantCustomFieldsmap

optional

map[string, string]

CreditGrantIDstring

optional

IssuedAtTime

optional

When the invoice was issued (UTC)

formatdate-time

NetPaymentTermsDaysfloat64

optional

NetsuiteSalesOrderIDstring

optional

This field's availability is dependent on your client's configuration.

PlanCustomFieldsmap

optional

map[string, string]

PlanIDstring

optional

formatuuid

PlanNamestring

optional

ResellerRoyalty

optional

Only present for contract invoices with reseller royalties.

Hide ParametersShow Parameters

Fractionstring

NetsuiteResellerIDstring

ResellerType

Hide ParametersShow Parameters

InvoiceResellerRoyaltyResellerTypeAwsconst

"AWS"

InvoiceResellerRoyaltyResellerTypeAwsProServiceconst

"AWS_PRO_SERVICE"

InvoiceResellerRoyaltyResellerTypeGcpconst

"GCP"

InvoiceResellerRoyaltyResellerTypeGcpProServiceconst

"GCP_PRO_SERVICE"

AwsOptions

optional

Hide ParametersShow Parameters

AwsAccountNumberstring

optional

AwsOfferIDstring

optional

AwsPayerReferenceIDstring

optional

GcpOptions

optional

Hide ParametersShow Parameters

GcpAccountIDstring

optional

GcpOfferIDstring

optional

SalesforceOpportunityIDstring

optional

This field's availability is dependent on your client's configuration.

StartTimestampTime

optional

Beginning of the usage period this invoice covers (UTC)

formatdate-time

Subtotalfloat64

optional

package main

import (
  "context"
  "fmt"
  "time"

  "github.com/Metronome-Industries/metronome-go"
  "github.com/Metronome-Industries/metronome-go/option"
)

func main() {
  client := metronome.NewClient(
    option.WithBearerToken("My Bearer Token"),
  )
  response, err := client.V1.Contracts.ScheduleProServicesInvoice(context.TODO(), metronome.V1ContractScheduleProServicesInvoiceParams{
    ContractID: metronome.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
    CustomerID: metronome.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
    IssuedAt: metronome.F(time.Now()),
    LineItems: metronome.F([]metronome.V1ContractScheduleProServicesInvoiceParamsLineItem{metronome.V1ContractScheduleProServicesInvoiceParamsLineItem{
      ProfessionalServiceID: metronome.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
    }}),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Data)
}

200 Example

{
  "data": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "credit_type": {
        "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "name": "name"
      },
      "customer_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "line_items": [
        {
          "credit_type": {
            "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "name": "name"
          },
          "name": "name",
          "total": 0,
          "applied_commit_or_credit": {
            "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "type": "PREPAID"
          },
          "commit_custom_fields": {
            "foo": "string"
          },
          "commit_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "commit_netsuite_item_id": "commit_netsuite_item_id",
          "commit_netsuite_sales_order_id": "commit_netsuite_sales_order_id",
          "commit_segment_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "commit_type": "commit_type",
          "custom_fields": {
            "foo": "string"
          },
          "discount_custom_fields": {
            "foo": "string"
          },
          "discount_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "ending_before": "2019-12-27T18:11:19.117Z",
          "group_key": "group_key",
          "group_value": "group_value",
          "is_prorated": true,
          "list_price": {
            "rate_type": "FLAT",
            "credit_type": {
              "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
              "name": "name"
            },
            "custom_rate": {
              "foo": "bar"
            },
            "is_prorated": true,
            "price": 0,
            "pricing_group_values": {
              "foo": "string"
            },
            "quantity": 0,
            "tiers": [
              {
                "price": 0,
                "size": 0
              }
            ],
            "use_list_prices": true
          },
          "metadata": "metadata",
          "netsuite_invoice_billing_end": "2019-12-27T18:11:19.117Z",
          "netsuite_invoice_billing_start": "2019-12-27T18:11:19.117Z",
          "netsuite_item_id": "netsuite_item_id",
          "postpaid_commit": {
            "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
          },
          "presentation_group_values": {
            "foo": "string"
          },
          "pricing_group_values": {
            "foo": "string"
          },
          "product_custom_fields": {
            "foo": "string"
          },
          "product_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "product_tags": [
            "string"
          ],
          "product_type": "product_type",
          "professional_service_custom_fields": {
            "foo": "string"
          },
          "professional_service_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "quantity": 0,
          "reseller_type": "AWS",
          "scheduled_charge_custom_fields": {
            "foo": "string"
          },
          "scheduled_charge_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "starting_at": "2019-12-27T18:11:19.117Z",
          "sub_line_items": [
            {
              "custom_fields": {
                "foo": "string"
              },
              "name": "name",
              "quantity": 0,
              "subtotal": 0,
              "charge_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
              "credit_grant_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
              "end_date": "2019-12-27T18:11:19.117Z",
              "price": 0,
              "start_date": "2019-12-27T18:11:19.117Z",
              "tier_period": {
                "starting_at": "2019-12-27T18:11:19.117Z",
                "ending_before": "2019-12-27T18:11:19.117Z"
              },
              "tiers": [
                {
                  "price": 0,
                  "quantity": 0,
                  "starting_at": 0,
                  "subtotal": 0
                }
              ]
            }
          ],
          "subscription_custom_fields": {
            "foo": "string"
          },
          "tier": {
            "level": 0,
            "starting_at": "starting_at",
            "size": "size"
          },
          "unit_price": 0
        }
      ],
      "status": "DRAFT, VOID, or FINALIZED",
      "total": 0,
      "type": "PLAN_ARREARS, SCHEDULED, USAGE, CORRECTION, CREDIT_PURCHASE, or SEAT_PURCHASE",
      "amendment_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "billable_status": "billable",
      "contract_custom_fields": {
        "foo": "string"
      },
      "contract_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "correction_record": {
        "corrected_invoice_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "memo": "memo",
        "reason": "reason",
        "corrected_external_invoice": {
          "billing_provider_type": "aws_marketplace",
          "external_status": "DRAFT",
          "invoice_id": "invoice_id",
          "issued_at_timestamp": "2019-12-27T18:11:19.117Z"
        }
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "custom_fields": {
        "foo": "bar"
      },
      "customer_custom_fields": {
        "foo": "string"
      },
      "end_timestamp": "2019-12-27T18:11:19.117Z",
      "external_invoice": {
        "billing_provider_type": "aws_marketplace",
        "external_status": "DRAFT",
        "invoice_id": "invoice_id",
        "issued_at_timestamp": "2019-12-27T18:11:19.117Z"
      },
      "invoice_adjustments": [
        {
          "credit_type": {
            "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "name": "name"
          },
          "name": "Monthly minimum ($1,000)",
          "total": 0,
          "credit_grant_custom_fields": {
            "foo": "string"
          },
          "credit_grant_id": "credit_grant_id"
        }
      ],
      "issued_at": "2019-12-27T18:11:19.117Z",
      "net_payment_terms_days": 0,
      "netsuite_sales_order_id": "netsuite_sales_order_id",
      "plan_custom_fields": {
        "foo": "string"
      },
      "plan_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "plan_name": "plan_name",
      "reseller_royalty": {
        "fraction": "fraction",
        "netsuite_reseller_id": "netsuite_reseller_id",
        "reseller_type": "AWS",
        "aws_options": {
          "aws_account_number": "aws_account_number",
          "aws_offer_id": "aws_offer_id",
          "aws_payer_reference_id": "aws_payer_reference_id"
        },
        "gcp_options": {
          "gcp_account_id": "gcp_account_id",
          "gcp_offer_id": "gcp_offer_id"
        }
      },
      "salesforce_opportunity_id": "salesforce_opportunity_id",
      "start_timestamp": "2019-12-27T18:11:19.117Z",
      "subtotal": 0
    }
  ]
}