Function setInvoiceStatus

Description

Changes the status of an invoice between TYMCZASOWA (draft) and AKTYWNA (active).

Workflow

1. Create invoice header with createInvoiceHead → status = TYMCZASOWA (default)
2. Add line items with createInvoiceItem
3. When finished, change status to AKTYWNA with setInvoiceStatus

Important notes

• Invoice with status TYMCZASOWA is a draft and can be freely modified
• Invoice with status AKTYWNA is finalized
• Cannot change status of invoice that has been sent to KSEF (has KSEF_NUMBER)

Arguments

• params :

      array (
            [ 'idInvoice' ] = string,  // Invoice ID (32 char GUID) - REQUIRED
            [ 'status' ] = string,     // 'AKTYWNA' or 'TYMCZASOWA' - REQUIRED
          )
      

Example

  require_once ( 'classUddsOx.php' ) ;

  $udds = new classUddsOx ;
  $udds->customerCode = [your_customerCode] ;
  $udds->login = [your_login] ;
  $udds->password = [your_password] ;
  $udds->serverUrl = 'http://api.dlaoperatora.pl/udds/' ;
  
  $params = array();
  $params['idInvoice'] = '00000004M1G221031126JF1B44ASNQ6D';
  $params['status'] = 'AKTYWNA';
  
  $ret = $udds->setInvoiceStatus($params);
  
  // $ret['data']['idInvoice'] - invoice ID
  // $ret['data']['previousStatus'] - status before change
  // $ret['data']['newStatus'] - status after change

Returns

Success response

{
  "status": "OK",
  "data": {
    "idInvoice": "00000004M1G221031126JF1B44ASNQ6D",
    "previousStatus": "TYMCZASOWA",
    "newStatus": "AKTYWNA"
  },
  "errors": []
}

Error response

{
  "status": "ERROR",
  "data": null,
  "errors": [
    { "code": 1004, "message": "Nie można zmienić statusu faktury wysłanej do KSEF (numer KSEF: ...)" }
  ]
}

Error codes

Related endpoints

• createInvoiceHead - Create invoice header (creates with TYMCZASOWA status)
• createInvoiceItem - Add line items
• getInvoice - Get invoice details
• sendInvoiceToKsef - Send invoice to KSEF