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 Connect REST API and Accessing EPR's Connect API and SchemaDocumentation.


Step-by-step guide

Call these EPR API methods in sequence.


Method
Notes
  1. POST /resources/document/upload/create
  • This method uploads the file to AWS S3 EPR and creates the data records entries in the following ERP tables: documents, documentPages, documentVersions and the documentPageVersions.
  • The document is then renderedprepped 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: Scout PDF inspector 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. 

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/batchCreate

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

...