Transaction Documents

Samooha POSTs documents to Geoplan in batches. A warehouse user on the Geoplan app picks a document and starts the scan. Geoplan POSTs scan results back only for GRN.

POST documents

POST https://api-stg-sling.rgoc.com.ph/api/v1/transaction-documents
x-api-key: <api-key>
Content-Type: application/json

Request body:

{
  "documents": [
    {
      "activity": "GR",
      "documentNo": "GRN-00001",
      "documentSource": "PI-26084567",
      "refNo": "ORFW26-310003494",
      "whCode": "10000-09",
      "lines": [
        {
          "sku": "RP80282244",
          "quantity": "2"
        }
      ]
    }
  ]
}

A single document object or a bare array of documents is also accepted, and quantity may be a number or a numeric string.

Activity is GR (Goods Receipt), GD (Goods Delivery), CR (Customer Return), or VR (Vendor Return).

Response:

{
  "statusCode": 201,
  "message": "Success",
  "data": [
    {
      "activity": "GR",
      "documentNo": "GRN-00001",
      "documentSource": "PI-26084567",
      "refNo": "ORFW26-310003494",
      "whCode": "10000-09"
    }
  ]
}

A batch is all-or-nothing. If any document is invalid, nothing is saved and the API returns 400 with the reasons.

Goods Receipt result

Geoplan posts the scanned result to Samooha. Spec: Samooha RFID API.

POST /rfid/grn
X-API-KEY: <api-key>
Content-Type: application/json

Request body:

{
  "documentNo": "GRN-00001",
  "documentSource": "PI-26084567",
  "lines": [
    {
      "sku": "RP80282244",
      "quantity": "2"
    }
  ]
}

Response:

{
  "code": "VALIDATION_FAILED",
  "message": "The GRN document is already posted."
}