Print Status & Signature Overview

When a document creation request encounters a digital signature failure in the database subsystem:

1. The document record is created: The database generates the internal document record, calculates totals, and assigns a sequential document_number.
2. The document link is suppressed: Because digital signature verification failed, document_link returns as an empty string "" to prevent distribution of an unauthenticated file.
3. Recovery limitation: The original document cannot be retrieved with its primary signed link. The document can only be recovered as a copy or reproduced after resolving the database certificate or password issue.

Error Response Structure

In the event of a print status or signature error, the API returns an HTTP 200 OK status with a negative print_status integer inside the data payload object.

Response Payload Example

{
    "error_code": 0,
    "client_message": "",
    "debug_message": "",
    "data": {
        "document_type": 1,
        "document_number": 1,
        "customer_id": 0,
        "document_identity": "00000000-0000-0000-0000-000000000000",
        "document_link": "",
        "print_status": -70,
        "amount": 1,
        "confirmation_number": 0
    }
}

Response Field Details

Error Code Glossary

Solutions & Remediation

Resolving Credential Mismatches (-70, -41)

These errors occur when the signature password does not match the signature certificate assigned to the database. To fix this, use one of the following methods:

1. Manual Entry in Online System: Log into Invoice Online (חשבונית אונליין), create a document manually, attempt to send it via email, and input the signature password when prompted by the system.
2. One-Time API Parameter: Include the signature password directly in a single API document creation request using the signature_pin parameter.
3. Support Escalation: Email your signature password to our support team so we can update it in your database configuration.

Resolving Expired Subscriptions (-42)

This error indicates that the digital signature service subscription associated with the account has expired or terminated.

1. Support Escalation: Contact our support team via email to renew the digital signature service plan and reactivate system signing permissions.

Resolving Logo Issues (-808)

If encountered on older builds:

1. Re-upload The Logo: Log into Invoice Online (חשבונית אונליין) and re-upload the logo file (PNG format preferred, JPG is also accepted) within the supported dimensions:
   • Small Logo: 2.5 × 2.5 cm (118px × 118px)
   • Header Replacement Logo: 4 × 19 cm (900px × 190px)

Resolving Missing Certificates (-801, -40)

These errors indicate that a digital signature certificate has not been generated or bound to your database.

1. Email Settings Verification: Log into Invoice Online (חשבונית אונליין) and navigate to Email Settings to Verify and complete the digital certificate configuration.
2. Support Escalation: If adjusting the email settings does not resolve the issue, contact our support team via email for manual certificate issuance and setup.

Handling & Recovery Workflow

1. Detect Status Error

   • Identify negative print_status in API payload.
   • Check the API response payload. If print_status is negative (e.g., -70, -41, -42, -808, -801, -40) and document_link is "", capture document_type and document_number.

2. Fix Signature Configuration

   • Apply resolution steps for error code.
   • For -70 / -41, update credentials via signature_pin, Invoice Online, or support.
   • For -42, contact support to renew the subscription.
   • For -808, resize and re-upload the logo in Invoice Online.
   • For -801 / -40, verify Email Settings in Invoice Online or contact support.

3. Recover or Reproduce

   • Option A: Recover as Copy / Option B: Cancel & Reproduce.
   • Recover Existing Document: Fetch the document as a copy via the document copy endpoint (original link cannot be restored).
   • Produce Fresh Document: Void the original record using Document.Cancel and re-submit Document.New to issue a primary document with a valid signature.

Technical Escalation & Support

If any other unlisted errors occur or if automated resolution steps fail, please reach out directly to support:

• iCREDIT Phone Support: Call 03-7466300 (Extension 3)
• API Technical Support: Email [email protected]