From a Blackbird perspective, a successful production of a PO consists of three steps, the planning step, the actual production start time and when the PO production has finished. The following documentation describes the events that we support for each of these steps. In the planning step, Blackbird expects to receive planning information about when the PO is scheduled to be produced, including product information, e.g. product name, quantity etc. In the latter two steps, Blackbird expects a PO reference (AUFNR below) including the times of when the PO was started and when it ended. We encourage our customers to implement these two on-demand, meaning when the operator starts and ends the PO in SAP. Alternatively, Blackbird can be used as an interface to start and stop batches if desired. In that case, the POST and POSL events are not necessary to implement.

Connection details

Endpoint: https://sap-bdc.cloud.blackbird.online/batches/<IDOCNUM>.xml (domain is subject to change)

Method: POST

Content-Type: application/xml (IDOC, see example below)

Events

We support the following events

• REL: Release PO, product order (batch), information (ERDAT + ERZEIT is the planned start time)
• POST: Start PO (ERDAT + ERZEIT is the start time) (requires REL to be fired)
• POSL(/SLUT): End PO (ERDAT + ERZEIT is the end time) (requires REL to be fired)
• TECO: Deleted flag (if the PO is "deleted" in SAP)

For batch-specific information, see the example below.

Example

<?xml version="1.0" encoding="UTF-8"?>
<ZBDCPLAN>
  <IDOC BEGIN="1">
    <EDI_DC40 SEGMENT="1"> **<!-- Required -->**
      <TABNAM>EDI_DC40</TABNAM> <!-- Optional - unused -->
      <MANDT>310</MANDT> <!-- Optional - unused -->
      <DOCNUM>0000000002555290</DOCNUM> **<!-- Required - added to meta data in Blackbird -->**
      <DOCREL>740</DOCREL> <!-- Optional - unused -->
      <STATUS>30</STATUS> <!-- Optional - unused -->
      <DIRECT>1</DIRECT> <!-- Optional - unused -->
      <OUTMOD>2</OUTMOD> <!-- Optional - unused -->
      <IDOCTYP>ZBDCPLAN</IDOCTYP> <!-- Optional - unused -->
      <MESTYP>ZBDC_PROD_PLAN</MESTYP> <!-- Optional - unused -->
      <SNDPOR>SAPRD1</SNDPOR> <!-- Optional - unused -->
      <SNDPRT>LS</SNDPRT> <!-- Optional - unused -->
      <SNDPRN>RD1CLNT310</SNDPRN> <!-- Optional - unused -->
      <RCVPOR>BLACKBIRD</RCVPOR> <!-- Optional - unused -->
      <RCVPRT>LS</RCVPRT> <!-- Optional - unused -->
      <RCVPRN>BLACKBIRD</RCVPRN> <!-- Optional - unused -->
      <CREDAT>20190513</CREDAT> **<!-- Optional - strict format - added to meta data in Blackbird -->**
      <CRETIM>103447</CRETIM> **<!-- Optional - strict format - added to meta data in Blackbird -->**
      <SERIAL>20190513103447</SERIAL> <!-- Optional - unused -->
    </EDI_DC40>
    <ZSDCPLAN01 SEGMENT="1"> **<!-- Required -->**
      <PLANT>0451</PLANT> <!-- Optional - unused -->
      <AUFNR>000001005360</AUFNR> **<!-- Required - Batch number in Blackbird -->**
      <GAMNG>         2.000</GAMNG> **<!-- Optional - data multiplier in Blackbird -->**
      <MATNR>000000000000103254</MATNR> **<!-- Optional - external product identifier -->**
      <MAKTX>Product name</MAKTX> **<!-- Optional - product name -->**
      <_-STTPEC_-SERTYPE> 3</_-STTPEC_-SERTYPE> <!-- Optional - unused -->
      <ERDAT>20190515</ERDAT> **<!-- Required - event time specific for STATUS below -->**
      <ERZEIT>000000</ERZEIT> **<!-- Required - event time specific for STATUS below -->**
      <AEDAT>00000000</AEDAT> <!-- Optional - unused -->
      <AEZEIT>000000</AEZEIT> <!-- Optional - unused -->
      <STATUS>REL;</STATUS> **<!-- Optional - One of REL, POST, SLUT/POSL and TECO, separated by ;, falls back to REL -->**
    </ZSDCPLAN01>
    <ZSDCPLAN02 SEGMENT="1"> <!-- Optional -->
      <VORNR>0500</VORNR> <!-- Optional - unused -->
      <ARBPL>640</ARBPL> **<!-- Optional - external production line name -->**
      <SETUP_MACH>     0.000</SETUP_MACH> <!-- Optional - unused -->
      <PROCESS_MACH>     0.000</PROCESS_MACH> <!-- Optional - unused -->
      <TEARDOWN_MACH>     0.000</TEARDOWN_MACH> <!-- Optional - unused -->
      <SETUP_LABOR>     0.000</SETUP_LABOR> <!-- Optional - unused -->
      <PROCESS_LABOR>     0.000</PROCESS_LABOR> <!-- Optional - unused -->
      <TEARDOWN_LABOR>     0.000</TEARDOWN_LABOR> <!-- Optional - unused -->
    </ZSDCPLAN02>
    <ZSDCPLAN03 SEGMENT="1"> **<!-- Optional - product parameters, strict naming -->**
      <UNIT_IN_PACK>28 PC</UNIT_IN_PACK>
      <PREPARATION>069</PREPARATION>
      <PREPARATION_TXT>Product name</PREPARATION_TXT>
      <FORMULATION>22</FORMULATION>
      <FORMULATION_TXT>Tablets - filmcoated</FORMULATION_TXT>
      <STRENGTH>20,00 MG</STRENGTH>
      <FOIL>ALU</FOIL>
      <FOIL_TXT>Alu-foil</FOIL_TXT>
      <HEIGHT>30 MM</HEIGHT>
      <LEAFLET>200 MM</LEAFLET>
      <HOTMELT>N</HOTMELT>
      <HOTMELT_TXT>NO</HOTMELT_TXT>
      <VIGNETTE>N</VIGNETTE>
      <VIGNETTE_TXT>NO</VIGNETTE_TXT>
      <PRINT_LABEL>N</PRINT_LABEL>
      <PRINT_LABEL_TXT>NO</PRINT_LABEL_TXT>
      <PRINT_CARTON>Y</PRINT_CARTON>
      <PRINT_CARTON_TXT>YES</PRINT_CARTON_TXT>
      <SEALING>N</SEALING>
      <SEALING_TXT>NO</SEALING_TXT>
      <PACKING_TYPE>BLI</PACKING_TYPE>
      <PACKING_TYPE_TXT>Blisterpack</PACKING_TYPE_TXT>
      <BLISTERS>2 PC</BLISTERS>
      <BANDEROLE>N</BANDEROLE>
      <BANDEROLE_TXT>NO</BANDEROLE_TXT>
    </ZSDCPLAN03>
    <ZSDCPLAN04 SEGMENT="1">
      <BULK_BATCH_1>0002005099</BULK_BATCH_1> **<!-- Optional - added to meta data in Blackbird -->**
    </ZSDCPLAN04>
  </IDOC>
</ZBDCPLAN>