Creates A New Receipt.
creates_a_new_receiptCreate a new material receipt in Procore by providing company and project IDs, along with receipt details like vendor, shipment, and receiving location.
Instructions
This endpoint handles HTTP POST requests and returns different response types based on the outcome of the operation. A successful creation returns a 200 OK response with the receipt header details, while various error conditions return appropriate error responses. company_id and project_id default to the values set by procore_set_config when omitted. Acts on the receipt and returns Procore's response for the operation. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: company_id, project_id. Procore API (v2.0): Resource Management > Materials Management. Endpoint: POST /rest/v2.0/companies/{company_id}/projects/{project_id}/materials_mgmt/receipts
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | JSON request body field — the name of the receipt. | |
| notes | No | JSON request body field — additional notes for the receipt. | |
| vendor | No | JSON request body field — name of vendor for receipt. | |
| signature | No | JSON request body field — the signature associated with the receipt. | |
| company_id | Yes | URL path parameter — the company identifier | |
| project_id | Yes | URL path parameter — the project identifier | |
| description | No | JSON request body field — the description of the receipt. | |
| destination | No | JSON request body field — the destination for this Materials Management operation | |
| received_at | No | JSON request body field — the timestamp when the receipt was received. | |
| received_by | No | JSON request body field — the name of the user who received the receipt. | |
| shipment_id | No | JSON request body field — the ID of the shipment associated with the receipt. | |
| inspected_by | No | JSON request body field — the name of the user who inspected the receipt. | |
| received_by_id | No | JSON request body field — the name of the user who received the receipt. | |
| purchase_order_id | No | JSON request body field — the ID of the purchase order associated with the receipt. | |
| receiving_location | No | JSON request body field — the receiving location for this Materials Management operation | |
| shipment_reference | No | JSON request body field — reference to the parent shipment | |
| receiving_location_id | No | JSON request body field — the ID of the location where the receipt was received. |