NAME

grid-po-create - Create a new Grid Purchase Order.

SYNOPSIS

grid po create [FLAGS] [OPTIONS] <–buyer-org BUYER> <–seller-org SELLER>

DESCRIPTION

This command allows for the creation of Grid Purchase Orders. It submits a Sabre transaction to create the purchase order. The options --buyer-org, --seller-org, --workflow-state, and --workflow-id are required.

FLAGS

-h, --help

Prints help information.

-q, --quiet

Do not display output.

-V, --version

Prints version information.

-v

Increases verbosity (the opposite of -q). Specify multiple times for more output.

OPTIONS

--alternate-id

Optionally include an alternate ID. This may be specified multiple times. An ID is of the format alternate_id_type:alternate_id. Examples: po_number:12348959 and/or internal_po_id:a8f9fke.

-k, --key

base name or path to a private signing key file

--buyer-org

Specify the organization that is buying the purchase order. This option is required.

--seller-org

Specify the organization that is selling the purchase order. This option is required.

--service-id

The ID of the service the payload should be sent to; required if running on Splinter. Format: <circuit-id>::<service-id>.

--url

URL for the REST API

--uid

Optionally specify the unique ID of the purchase order. If not specified, will be randomly generated.

--wait

Maximum number of seconds to wait for the batch to be committed.

--workflow-state

Specifies the initial workflow state of the purchase order.

--workflow-id

Specifies the ID of the workflow to be used for the purchase order. Built-in workflows are “built-in::system_of_record::v1”, which uses buyer and seller roles, and “built-in::collaborative::v1”, which uses collaborative partner roles. For more information on these workflows, see https://github.com/splintercommunity/grid-rfcs/blob/main/text/0025-purchase-order.md .

EXAMPLES

The command

$ grid po create \
    --buyer-org crgl \
    --seller-org crgl2 \
    --workflow-state issued \
    --workflow-id built-in::collaborative::v1
    --alternate-id po_number:8329173 \
    --wait 10

will generate a purchase order owned by the crgl organization, with the state of issued in the built-in collaborative workflow, and an alternate ID of po_number:8329173. It will generate output similar to the following (the unique ID is randomly generated in this case):

Submitting request to create purchase order...
Submitted batch: 55f83da3ff883dec1b4a075f55ff57aecf8428b3c07b3e8041bee5012ce2bebe4c43dab59865c30718f6960f48f380758a079597101af57e42295ec0b6203cef
Batch and transaction structure was valid. Batch queued.

ENVIRONMENT VARIABLES

CYLINDER_PATH

Colon-separated path used to search for the key which will be used to sign transactions

GRID_DAEMON_ENDPOINT

Specifies a default value for --url

GRID_DAEMON_KEY

Specifies a default value for -k, --key

GRID_SERVICE_ID

Specifies a default value for --service-id

SEE ALSO