Attachments

As a default, KSeF does not accept any attachments. It is not possible to forward anything except Faktura FA(2) Object.

However, A-Cube platform supports additional information about attachments in sended payload. To do this, Attachments and Faktura Object must be wrapped by Invoice object.

Copy
Copied
<?xml version="1.0" encoding="utf-8"?>
<invoice>
  <?xml version="1.0" encoding="UTF-8"?>
  <Faktura xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
           xmlns="http://crd.gov.pl/wzor/2023/06/29/12648/">
    <Naglowek>
      <KodFormularza kodSystemowy="FA (2)" wersjaSchemy="1-0E">FA</KodFormularza>
      <WariantFormularza>2</WariantFormularza>
      <DataWytworzeniaFa>2023-09-12T13:54:35.3250835+02:00</DataWytworzeniaFa>
      <SystemInfo>Aplikacja Podatnika KSeF</SystemInfo>
    </Naglowek>
    <Podmiot1>
      <DaneIdentyfikacyjne>
        <NIP>ENTER-NIP-HERE</NIP>
        <Nazwa>test</Nazwa>
      </DaneIdentyfikacyjne>
      <Adres>
        <KodKraju>PL</KodKraju>
        <AdresL1>test sender</AdresL1>
      </Adres>
    </Podmiot1>
    <Podmiot2>
      <DaneIdentyfikacyjne>
        <NIP>ENTER-NIP-HERE</NIP>
      </DaneIdentyfikacyjne>
      <Adres>
        <KodKraju>PL</KodKraju>
        <AdresL1>test recipient</AdresL1>
      </Adres>
    </Podmiot2>
    <Fa>
      <KodWaluty>PLN</KodWaluty>
      <P_1>2023-09-12</P_1>
      <P_2>TEST</P_2>
      <P_6>2023-09-12</P_6>
      <P_13_1>1000</P_13_1>
      <P_14_1>230</P_14_1>
      <P_15>1230</P_15>
      <Adnotacje>
        <P_16>2</P_16>
        <P_17>2</P_17>
        <P_18>2</P_18>
        <P_18A>2</P_18A>
        <Zwolnienie>
          <P_19N>1</P_19N>
        </Zwolnienie>
        <NoweSrodkiTransportu>
          <P_22N>1</P_22N>
        </NoweSrodkiTransportu>
        <P_23>2</P_23>
        <PMarzy>
          <P_PMarzyN>1</P_PMarzyN>
        </PMarzy>
      </Adnotacje>
      <RodzajFaktury>VAT</RodzajFaktury>
      <FaWiersz>
        <NrWierszaFa>1</NrWierszaFa>
        <P_7>test</P_7>
        <P_8A>działa</P_8A>
        <P_8B>1</P_8B>
        <P_9A>1000</P_9A>
        <P_11>1000</P_11>
        <P_12>23</P_12>
      </FaWiersz>
    </Fa>
  </Faktura>
  <Attachments>
        <base64>PHRlc3Q+amFracWbIHN0cmluZyBpa3MgZGU8L3Rlc3Q+</base64>
        <filename>nazwa pliku</filename>
        <extension>xml</extension>
      <filesize>33</filesize>
  </Attachments>
  <Attachments>
        <base64>PHRlc3Q+amFracWbIHN0cmluZyBpa3MgZGU8L3Rlc3Q+</base64>
        <filename>nazwa pliku 2</filename>
        <extension>jpg</extension>
        <filesize>33</filesize>
  </Attachments>
</invoice>

We add information about every attachment separately like this:

Copy
Copied
<Attachments>
    <base64>PHRlc3Q+amFracWbIHN0cmluZyBpa3MgZGU8L3Rlc3Q+</base64>
    <filename>nazwa pliku</filename>
    <extension>xml</extension>
    <filesize>33</filesize>
</Attachments>

Attachments are stored on A-Cube secure storage space.

Attachments can be accessed by recipient of the invoice if there is known phone number or e-mail of the recipient. Access to the attachments is possible via special link and additional authentication.

Endpoints

To find out more about attachments take a look on InvoiceAttachments API