Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This article describes how to use e-PlanREVIEW® (EPR)'s Connect API to upload documents for a particular project.

...

A project record has been created. See Creating a new Project3 Easy Steps for a Light Integration to EPR. Basic understanding of EPR APIs see Getting Started with EPR REST API and Accessing EPR's API and Documentation.


Step-by-step guide

Call this method to upload plan review documents (in PDF format) and supporting attachments (any file format) for a particular Project,these EPR API methods in sequence.


Method
Notes
  1. POST
/uploadDocument

Scout PDF inspector will be invoked automatically.

Plan review documents
  1.  /resources/document/upload/create
  • This method uploads the file to EPR and creates entries in the following ERP tables: documents, documentPages, documentVersions and the documentPageVersions.
  • The document is then prepped for plan review, we call this process 'redending'.
  • If the incoming document is a new version of a previously submitted document, you must set the documentPrior_id value equal to the vendor_id of the first submittal.

NOTE: PDF Scout™ Inspector Tool will be invoked automatically for each incoming plan review document. Files rejected by Scout cannot be uploaded to EPR. The customer must correct the issues noted before proceeding.

GET/project/{project_id}/documents

Call this method to retrieve the data records(s) for your newly uploaded document. (The document ID value will be required if you intend to create plan review assignments.)

Next Steps

...

 

2.POST /resources/document/upload/intake
  • If your application will pass plan review assignments to EPR:
    • Set 'needsIntake' to False.
    • Pass the PK/GUID value for the document to the 'vendor_id' field (Required)

*Vendor_ID accepts a numeric or string (50 chars). Vendor_id's must be unique in the documents table.

Otherwise, if your application will not pass plan review assignments to EPR:

  • Call this method and set 'needsIntake' to True. This will make the Project Intake tab visible so that an EPR user can manually perform intake and create assignments.
3. POST/resources/documentAssignments

Creates assignment records and display them in the EPR Review page.

Call this method after Intake if your application passes plan review assignments to EPR. Otherwise, do not call this method.

  1. Pass your GUID/PK value for the assignment to the 'vendor_id' field. (Required). This will allow EPR to return the assignment 'Status' to the appropriate task/assignment.

*Vendor_ID accepts a numeric or string (50 chars). Vendor_id's must be unique in the documentAssignments table.

  1. Include the 'documentVersion_vendor_id' value (PK/GUID) (Required). It should always point to the most recent document version. Do not pass the document version vendor ID for an earlier version.

*Vendor_ID accepts a numeric or string (50 chars). Vendor_id's must be unique in the documentVersion table.



Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@10c5c
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "kb-how-to-article" and type = "page" and space = "EKB"
labelskb-how-to-article

...