DOCAPP Documentary credit application message (D08A)

This is the standard EDIFACT D08A spec, with 18 loops and 62 segment positions, as OpenEDI JSON, an ediFabric C# template and an ediFabric Native model. To change it for a trading partner, customize it in the EDI Spec Builder.

Loading the spec…
The spec as an OpenAPI 3 schema with x-openedi-* extensions, for ediFabric Native, ediFabric Cloud and the EDI Spec Builder. Download OpenEDI (89 KB) Generate classes
The ediFabric .NET template, class TSDOCAPP. It needs the common segments, composites and codes of EDIFACT D08A, one download for every transaction in the version. Download C# (1 KB) Common files (57 KB)
The intermediary model ediFabric Native loads with set_map. Native supports X12 today, and EDIFACT is coming. Download Native (1 KB)

Use the DOCAPP spec in your code

ediFabric .NET

Add the C# template and its common files to your project, or reference the template NuGet package, and read DOCAPP files into TSDOCAPP objects. See ediFabric .NET.

ediFabric Native

Native supports X12 today, and EDIFACT is coming. When it's available, map version D08A to this Native model with set_map to parse DOCAPP files to JSON from Python, Java, C or C#. See ediFabric Native.

OpenEDI

Select Customize in Spec Builder to copy the spec under your own name, change it for your partner, and parse files against it in EdiNation, ediFabric Native or ediFabric Cloud. Read about OpenEDI.

Generate DOCAPP classes in Python, Java, Node.js, Go, Rust or C

The OpenEDI file describes each DOCAPP as JSON. To work with DOCAPP data as typed objects, generate classes from the OpenEDI file in your language; the root class is TSDOCAPP. The classes keep the loops, segments, lengths and code lists, but not the EDI data formats. Read more in Generate a class from OpenEDI.

Python: datamodel-code-generator. Node.js: openapi-typescript. Java, Go, Rust and C: OpenAPI Generator.

DOCAPP structure

Loops and segments of the standard DOCAPP, with their usage and maximum repeats.

IDNameUsageMax use
UNHMessage HeaderOptional1
BGMBEGINNING OF MESSAGEMandatory1
INPPARTIES AND INSTRUCTIONMandatory5
FCAFINANCIAL CHARGES ALLOCATIONMandatory3
BUSBUSINESS FUNCTIONOptional1
RFFREFERENCEOptional1
DTMDATE/TIME/PERIODOptional2
FTXFREE TEXTOptional10
Loop FIIFINANCIAL INSTITUTION INFORMATIONMandatory5
FIIFINANCIAL INSTITUTION INFORMATIONMandatory1
RFFREFERENCEOptional2
CTACONTACT INFORMATIONOptional1
COMCOMMUNICATION CONTACTOptional5
Loop NADNAME AND ADDRESSMandatory9
NADNAME AND ADDRESSMandatory1
RFFREFERENCEOptional1
CTACONTACT INFORMATIONOptional1
COMCOMMUNICATION CONTACTOptional5
Loop DTMDATE/TIME/PERIODMandatory1
DTMDATE/TIME/PERIODMandatory1
LOCPLACE/LOCATION IDENTIFICATIONOptional1
Loop MOAMONETARY AMOUNTMandatory5
MOAMONETARY AMOUNTMandatory1
Loop ALCALLOWANCE OR CHARGEOptional1
ALCALLOWANCE OR CHARGEMandatory1
PCDPERCENTAGE DETAILSOptional2
Loop LOCPLACE/LOCATION IDENTIFICATIONOptional3
LOCPLACE/LOCATION IDENTIFICATIONMandatory1
DTMDATE/TIME/PERIODOptional1
Loop PAIPAYMENT INSTRUCTIONSMandatory1
PAIPAYMENT INSTRUCTIONSMandatory1
LOCPLACE/LOCATION IDENTIFICATIONOptional1
Loop PYTPAYMENT TERMSMandatory5
PYTPAYMENT TERMSMandatory1
FIIFINANCIAL INSTITUTION INFORMATIONOptional1
DTMDATE/TIME/PERIODOptional1
MOAMONETARY AMOUNTOptional1
PCDPERCENTAGE DETAILSOptional1
FTXFREE TEXTOptional1
Loop TODTERMS OF DELIVERY OR TRANSPORTOptional1
TODTERMS OF DELIVERY OR TRANSPORTMandatory1
LOCPLACE/LOCATION IDENTIFICATIONOptional1
Loop TSRTRANSPORT SERVICE REQUIREMENTSOptional1
TSRTRANSPORT SERVICE REQUIREMENTSMandatory1
LOCPLACE/LOCATION IDENTIFICATIONOptional5
Loop INPPARTIES AND INSTRUCTIONOptional5
INPPARTIES AND INSTRUCTIONMandatory1
FTXFREE TEXTOptional1
DTMDATE/TIME/PERIODOptional2
Loop GEIPROCESSING INFORMATIONOptional10
GEIPROCESSING INFORMATIONMandatory1
MOAMONETARY AMOUNTOptional1
LOCPLACE/LOCATION IDENTIFICATIONOptional2
NADNAME AND ADDRESSOptional1
RCSREQUIREMENTS AND CONDITIONSOptional1
FTXFREE TEXTOptional10
Loop RFFREFERENCEMandatory9
RFFREFERENCEMandatory1
DTMDATE/TIME/PERIODOptional1
FTXFREE TEXTOptional2
Loop DOCDOCUMENT/MESSAGE DETAILSMandatory20
DOCDOCUMENT/MESSAGE DETAILSMandatory1
MOAMONETARY AMOUNTOptional1
PCDPERCENTAGE DETAILSOptional1
LOCPLACE/LOCATION IDENTIFICATIONOptional1
FTXFREE TEXTOptional1
Loop ICDINSURANCE COVER DESCRIPTIONOptional20
ICDINSURANCE COVER DESCRIPTIONMandatory1
DTMDATE/TIME/PERIODOptional1
FTXFREE TEXTOptional9
Loop ALIADDITIONAL INFORMATIONOptional9
ALIADDITIONAL INFORMATIONMandatory1
Loop NADNAME AND ADDRESSOptional3
NADNAME AND ADDRESSMandatory1
CTACONTACT INFORMATIONOptional1
COMCOMMUNICATION CONTACTOptional5
Loop AUTAUTHENTICATION RESULTOptional1
AUTAUTHENTICATION RESULTMandatory1
DTMDATE/TIME/PERIODOptional1
UNTMessage TrailerOptional1