Warnings

A number of resources expose a warning object to provide insight into the status of each entity and potential steps that may be blocking future actions such as running payroll.

What a warning blocks

Whether a warning blocks anything depends on the record carrying it. For how this fits the wider picture of what a payroll needs, see Payroll Data Requirements.

Warnings on a business entity

Every one must be resolved before the business can be approved, and a business that is not approved cannot run payroll.

Type	Resolution
`business_verification_failed`	Verification did not pass. See Company Setup.
`business_verification_incomplete`	Verification is requested or part-complete. Supply the outstanding details.
`business_legal_information_not_provided`	Set `legal_name` and `legal_registration_number`.
`business_number_not_provided`	Set the `account_identifier` on a CRA Remittance Account.
`address_not_provided`	Set `address_line_1`, `city`, `country_code` and `postal_code`, plus `province_code` for Canada.
`contact_not_provided`	Set `contact_name`, `contact_area_code` and `contact_phone_number`.
`bank_account_doesnt_exists`	Add a bank account for the business entity.
`bank_account_pad_not_signed`	Complete the PAD signer fields on one of its bank accounts. See Banking.
`province_of_employment_not_configured`	Set the `ca::province_of_employment` tax property. See Province of Employment.
`remitter_type_not_provided`	Set `remitter_type` on the business entity, or on the remittance account that lacks one.

Warnings on a payroll or pay stub

Nmbr re-evaluates these as the underlying data changes. If any is present when you approve, it blocks approval.

Type	Resolution
`remitter_type_not_provided`	Set `remitter_type` on the business entity, or on the remittance account that lacks one.
`negative_net_amount_on_pay_stub`	Correct the line items producing a negative net.
`bank_account_doesnt_exist_for_payee`	Add a bank account for the employee or contractor.
`negative_total_on_remittance_account`	Correct the amounts on the affected remittance account.
`missing_cra_remittance_account_enrollment`	Complete CRA remittance enrolment.
`missing_rq_remittance_account_enrollment`	Complete Revenu Québec remittance enrolment.
`missing_cra_remittance_account_identifier`	Set the CRA account identifier.
`missing_rq_remittance_account_identifier`	Set the Revenu Québec account identifier.

Remitter type and remittance accounts are covered in Deductions and Remittances and Tax Agency Configuration.

Warnings on an employee or contractor

These do not block payroll. They flag data needed for year-end filing, and a payroll may be approved and paid normally without them.

Type	Meaning
`sin_not_provided`	No SIN on the record. Required for a correct T4 or RL-1.
`dob_not_provided`	No date of birth on the record. Required for year-end filing.
`address_not_provided`	No address on the record. Required for a correct T4 or RL-1.

Warnings on a bank account

These do not block payroll. Nmbr runs additional validation on bank details and reports the result as a warning rather than rejecting the request.

Type	Meaning
`bank_account_unrecognized_institution`	The institution number is not one Nmbr recognises.
`bank_account_unrecognized_transit`	The institution is known, but the transit is not a branch Nmbr holds for it.
`bank_account_invalid_account`	The account number fails the check-digit rules its institution publishes in Payments Canada Standard 006.

A successful response on a bank account is not confirmation the account is valid. A failed check appears in the account’s warnings. The same checks are available on POST /bank_accounts/lookup before you create an account.

Warning object

"warnings": {
    "object": "list",
    "data": [
        {
            "id": null,
            "object": "warning",
            "data": {
                "namespace": "onboarding",
                "type": "business_verification_incomplete"
            },
            "links": {
                "self": null
            }
        },
        {
            "id": null,
            "object": "warning",
            "data": {
                "namespace": "onboarding",
                "type": "business_legal_information_not_provided"
            },
            "links": {
                "self": null
            }
        }
    ]
},

Overview

Bulk & Batch Operations

Partner

Companies

Employees

Contractors

Payrolls

Line Items

Banking

Reporting

Forms

Vacation Pay

Lookups

Calculations

Miscellaneous

What a warning blocks

Warnings on a business entity

Warnings on a payroll or pay stub

Warnings on an employee or contractor

Warnings on a bank account

Warning object

​What a warning blocks

​Warnings on a business entity

​Warnings on a payroll or pay stub

​Warnings on an employee or contractor

​Warnings on a bank account

​Warning object

What a warning blocks

Warnings on a business entity

Warnings on a payroll or pay stub

Warnings on an employee or contractor

Warnings on a bank account

Warning object