Export a closeout package

An export freezes the project at one instant and writes everything a delivery needs into one folder and one ZIP.

Before you start

• The project’s network, traces and photos are recorded, and DATABASE_URL and ASBUILT_BLOB_DIR are set.
• You know the freeze instant: the moment whose state you deliver, in UTC, as YYYY-MM-DDTHH:MM:SSZ. Records captured after it are not in the package.
• You know the export profile of the receiving authority (Profiles and authorities).

Steps

1. Export into a new, empty folder:

   $ asbuilt export --project ee-demo --profile ee.default.v1 --frozen-at 2026-01-01T00:00:00Z --out closeout --allow-grid-absent 'ee.*' --allow-unverified-profile
   Warning CRS_GRID_ABSENT: grid ee_mra_estgeoid2017.tif of pipeline ee.etrs89.lest97-eh2000.v1 is not installed; coordinates are exported as stored (delivery CRS, never transformed), the WGS84 copy is not produced
   …
   manifest_sha256 d0b2a38e6d15840031a1bf30c8defc48c72994c218b2bd569fc0da82c178e3df
   

   --allow-grid-absent and --allow-unverified-profile are needed only while an input is missing; each says so in the package:

   Estonian heights are not available yet. The licensed EST-GEOID2017 geoid model is not installed. Until it is, Estonian exports need --allow-grid-absent 'ee.*' and record that in the package, and field heights for Estonian projects wait with GRID_ABSENT. Norwegian projects are not affected.

2. Read every line that starts with Warning or Blocking. Each names its code; Codes and statuses says what it means. A Blocking line stops the export and nothing is written. Warnings are recorded in the package and printed in the closeout book.

3. Note the manifest_sha256. It identifies this package exactly (Exports never change).

4. When this is the package you deliver, record it: Record a delivered package.

Check

The folder holds the ZIP, the drawing, the data files, the book, manifest.json, package.json, evidence/ and traces/ (Closeout package format). Exporting again into another folder gives the same manifest_sha256.

What can go wrong

You see	Meaning	Do
exists and is not an empty directory	The output folder has files in it. An export never overwrites anything.	Choose a new folder.
PROFILE_UNVERIFIED as Blocking	The profile is provisional.	Use a production profile, or add --allow-unverified-profile and tell the recipient.
CRS_GRID_ABSENT as Blocking	A grid the project needs is missing.	Install it, or allow it explicitly while you wait for it.
TRACE_FAIL	A fibre fails its optical limits.	Decide with the client; the book reports it either way.
DXF_NO_LAYER	The profile has no layer for a node or span type in the project.	Add it in a new profile version.