orb-billing/resources/items.d.ts

The official TypeScript library for the Orb API

import { APIResource } from "../resource.js";
import * as Core from "../core.js";
import { Page, type PageParams } from "../pagination.js";
export declare class Items extends APIResource {
    /**
     * This endpoint is used to create an [Item](/core-concepts#item).
     */
    create(body: ItemCreateParams, options?: Core.RequestOptions): Core.APIPromise<Item>;
    /**
     * This endpoint can be used to update properties on the Item.
     */
    update(itemId: string, body: ItemUpdateParams, options?: Core.RequestOptions): Core.APIPromise<Item>;
    /**
     * This endpoint returns a list of all Items, ordered in descending order by
     * creation time.
     */
    list(query?: ItemListParams, options?: Core.RequestOptions): Core.PagePromise<ItemsPage, Item>;
    list(options?: Core.RequestOptions): Core.PagePromise<ItemsPage, Item>;
    /**
     * Archive item
     */
    archive(itemId: string, options?: Core.RequestOptions): Core.APIPromise<Item>;
    /**
     * This endpoint returns an item identified by its item_id.
     */
    fetch(itemId: string, options?: Core.RequestOptions): Core.APIPromise<Item>;
}
export declare class ItemsPage extends Page<Item> {
}
/**
 * The Item resource represents a sellable product or good. Items are associated
 * with all line items, billable metrics, and prices and are used for defining
 * external sync behavior for invoices and tax calculation purposes.
 */
export interface Item {
    /**
     * The Orb-assigned unique identifier for the item.
     */
    id: string;
    /**
     * The time at which the item was created.
     */
    created_at: string;
    /**
     * A list of external connections for this item, used to sync with external
     * invoicing and tax systems.
     */
    external_connections: Array<Item.ExternalConnection>;
    /**
     * User specified key-value pairs for the resource. If not present, this defaults
     * to an empty dictionary. Individual keys can be removed by setting the value to
     * `null`, and the entire metadata mapping can be cleared by setting `metadata` to
     * `null`.
     */
    metadata: {
        [key: string]: string;
    };
    /**
     * The name of the item.
     */
    name: string;
    /**
     * The time at which the item was archived. If null, the item is not archived.
     */
    archived_at?: string | null;
}
export declare namespace Item {
    /**
     * Represents a connection between an Item and an external system for invoicing or
     * tax calculation purposes.
     */
    interface ExternalConnection {
        /**
         * The name of the external system this item is connected to.
         */
        external_connection_name: 'stripe' | 'quickbooks' | 'bill.com' | 'netsuite' | 'taxjar' | 'avalara' | 'anrok' | 'numeral';
        /**
         * The identifier of this item in the external system.
         */
        external_entity_id: string;
    }
}
export interface ItemCreateParams {
    /**
     * The name of the item.
     */
    name: string;
    /**
     * User-specified key/value pairs for the resource. Individual keys can be removed
     * by setting the value to `null`, and the entire metadata mapping can be cleared
     * by setting `metadata` to `null`.
     */
    metadata?: {
        [key: string]: string | null;
    } | null;
}
export interface ItemUpdateParams {
    external_connections?: Array<ItemUpdateParams.ExternalConnection> | null;
    /**
     * User-specified key/value pairs for the resource. Individual keys can be removed
     * by setting the value to `null`, and the entire metadata mapping can be cleared
     * by setting `metadata` to `null`.
     */
    metadata?: {
        [key: string]: string | null;
    } | null;
    name?: string | null;
}
export declare namespace ItemUpdateParams {
    /**
     * Represents a connection between an Item and an external system for invoicing or
     * tax calculation purposes.
     */
    interface ExternalConnection {
        /**
         * The name of the external system this item is connected to.
         */
        external_connection_name: 'stripe' | 'quickbooks' | 'bill.com' | 'netsuite' | 'taxjar' | 'avalara' | 'anrok' | 'numeral';
        /**
         * The identifier of this item in the external system.
         */
        external_entity_id: string;
    }
}
export interface ItemListParams extends PageParams {
}
export declare namespace Items {
    export { type Item as Item, ItemsPage as ItemsPage, type ItemCreateParams as ItemCreateParams, type ItemUpdateParams as ItemUpdateParams, type ItemListParams as ItemListParams, };
}
//# sourceMappingURL=items.d.ts.map