Attachment

Help: Synchronize attachments

With the attribute "externalCheckSum", you can synchronize your attachments. We support working with your own internal attachment id. We will block "Vollabgleich" (regularly deleting & posting the same attachment) for attachments from 23.12.2015.


Howto synchronize attachments?


  • Define a checksum in your application and send it within the new attribute "externalCheckSum" by POST ATTACHMENT request.
  • We save the value and we hand it out by GETALL ATTACHMENTS and GETBYID ATTACHMENT. You compare the value with the value in your application and decide, if the attachment needs to be updated.
  • OR: Use the attachment/@modification to find out wheather the attachment has changed

Field characteristics:


  • Name = externalCheckSum
  • Position: below the attribute "externalId"
  • Length = 255 characters
  • Allowed values =  a-z A-Z 0-9 _ - + .

XSD:

            <xs:element name="externalCheckSum" type="xs:string" minOccurs="0">
                <xs:annotation>
                    <xs:documentation xml:lang="en">A customer specific checksum of this attachment</xs:documentation>
                    <xs:documentation xml:lang="de-DE">Eine kundenspezifische Vergleichssumme dieses Anhangs</xs:documentation>
                </xs:annotation>
            </xs:element>

SDK update


  • .NET SDK done. Automatic synchronization: Github release
  • PHP SDK done. Provision of externalCheckSum: Github release
  • Java SDK work in progress. Provision of externalCheckSum