---
schema_version: "1"
id: aeceda5406e5df1549b38f755a3f3c65dd285c757a968edbae8ef338e57bceda
title: InvoiceBatchRunCriteria
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_invoicebatchruncriteria.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_invoicebatchruncriteria.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: aa58e3da9812708175535a09870e4e2b98f5d97814cf09256fd63a60d5b904c9
description: Represents a batch processing job and its required criteria in Subscription Management. During an invoice batch run, all billing schedules that meet the specified criteria are processed, resulting in the generation of invoices. This object is available in API version 55.0 and later.
---
# InvoiceBatchRunCriteria

Represents a batch processing job and its required criteria in Subscription Management. During an invoice batch run, all billing schedules that meet the specified criteria are processed, resulting in the generation of invoices. This object is available in API version 55.0 and later.

A scheduled invoice batch run tells the system to start the run at a scheduled date and time by using certain criteria. The scheduler includes the matching criteria, which are used to evaluate the billing schedules. Billing schedules that meet the specified criteria are included for processing in the invoice batch run.

## Supported Calls

describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()

## Special Access Rules

This object is available with Subscription Management and Billing (Revenue Cloud).

For information about this object that's available with Billing (Revenue Cloud), including its special access rules, see the [Revenue Cloud Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.264.0.revenue_lifecycle_management_dev_guide.meta/revenue_lifecycle_management_dev_guide/sforce_api_objects_invoicebatchruncriteria.htm "HTML (New Window)").

## Fields

| Field | Details |
| --- | --- |
| Comments | 
Type

textarea

Properties

Filter, Nillable, Sort

Description

Optional user-defined information about the batch run criteria.



 |
| CriteriaExpression | 

Type

textarea

Properties

Filter, Nillable, Sort

Description

The formula that specifies criteria for filtering the billing schedules. For example, we can filter billing schedules by currency code.



 |
| CriteriaMatchType | 

Type

picklist

Properties

Defaulted on create, Filter, Group, Restricted picklist, Sort

Description

The type of matching criteria required for the batch.

Valid value is MatchAll.

The default value is MatchAll.



 |
| ExpectedInvoiceStatus | 

Type

picklist

Properties

Filter, Group, Nillable, Restricted picklist, Sort

Description

The type of invoice a batch run generates.

Valid values are:

- Draft
- Posted

This field is available in API version 60.0 and later.



 |
| InvoiceBatchRunCriteriaNumber | 

Type

string

Properties

Autonumber, Defaulted on create, Filter, idLookup, Sort

Description

System-generated sequential number.



 |
| OwnerId | 

Type

reference

Properties

Filter, Group, Sort

Description

System-generated field. The ID of the user who created the BillingBatchScheduler record. Its UI label is Owner.

This field is a polymorphic relationship field.

Relationship Name

Owner

Relationship Type

Lookup

Refers To

Group, User



 |