When an e-Taxes action fails or takes long

User guide
Who this is for
Everyone who starts e-Taxes actions
Time to read
4 min
Prerequisites
You've read Following an e-Taxes action

What you'll learn#

  • What to do when there is no ASAN İmza number to choose
  • What happens when you don't confirm on your phone, or the codes don't match
  • What to do when an action fails, is done only in part or has no clear result
  • When to try again, and when to ask VAT Portal support

There's no number to choose#

If the action window has no number for you, it says so and won't start. In Finance the message reads, for example, An ASAN İmza number is required to sign in to e-Taxes, even when you upload without signing. Add one on the ASAN İmza page. In the Tax module it reads An ASAN İmza number is required to continue. Add one on the ASAN İmza page.

Add your number on the ASAN İmza page, or ask your administrator to add it. See Adding your ASAN İmza number.

If the window shows someone else's number, pick yours in the phone field before you start. Otherwise the request goes to their phone.


You didn't confirm on your phone in time#

An ASAN İmza request on the phone waits only a short time. If you don't confirm it, VAT Portal can't sign in to e-Taxes. In the live progress, the last entries read Failed to authenticate, and the action ends as Failed.

Because the sign-in failed, nothing was done at e-Taxes. Start the action again and keep your phone at hand. Confirm the new request, not an old one.

A failure notification in the bottom-right corner titled "Upload 1 invoice(s) to e-Taxes", next to the live progress whose last entry reads Failed to authenticate.

The codes don't match#

If the code on your phone isn't the one VAT Portal shows (Confirmation code: … in the live progress), don't confirm. Decline the request on the phone. The action then fails, which is what you want.

Then check that you started only one action, and start it again. If the codes still don't match, or your phone asks when you haven't started anything, stop and contact VAT Portal support.


The action didn't start#

Sometimes the window shows an error right after you start, for example The e-Taxes operation could not be started. Nothing was sent. Read the message, fix what it asks for, and start again.

Two messages mean that the result is not known, even though no progress appeared:

  • No process number came back, so the result is unknown. Refresh the list before you try again.
  • The request was accepted, but no process number came back. Refresh the document before you try again.

In both cases, refresh the document first and look at its e-Taxes status. Start again only if nothing changed.


Part of it was done#

For an action on several documents, the notification may read Completed with issues. Review the failed or incomplete items before continuing. The live progress shows how many documents were Successful, Failed and Skipped, and Items requiring attention lists the ones that need you.

What e-Taxes accepted stays done. Refresh the list, look at the documents that didn't go through, fix what their message says, and start the action again only for them.


There's no clear result#

When VAT Portal can't confirm how an action ended, it says so instead of guessing. The status is Outcome unknown, and the message is one of these:

  • The final outcome could not be confirmed. Refresh the related document before retrying the action.
  • VAT Portal couldn't confirm the result in time. Don't start it again yet: refresh the document to see its latest status.
  • The process status could not be read. The decision may still be running or may have finished; check again before repeating it.
  • The job's result could not be read, and the documents still show their earlier status. The decision may still be running or may have failed; check e-Taxes before repeating it.

The action may still be running at e-Taxes, or may have finished. Don't start it again straight away:

  1. If the notification has Check again, click it. VAT Portal reads the result again; it doesn't repeat the action.
  2. Refresh the document and look at its status.
  3. For an approval, rejection or cancellation, check the qaimə on the e-Taxes site too.
  4. Start the action again only when you're sure it didn't happen.

When e-Taxes is busy#

When e-Taxes answers slowly, actions take longer and are more likely to end as Failed or Outcome unknown. Some windows tell you directly, for example e-Taxes reasons aren't available right now, so a cancellation can't be sent. Try again later. Wait a while, then try again, following the steps above.


Try again, or ask support?#

What you seeWhat to do
No number, or the wrong numberFix the number, then start again
Failed to authenticateStart again and confirm on your phone in time
The codes don't matchDecline, then start again; if it repeats, ask VAT Portal support
Completed with issuesStart again only for the documents that failed
Outcome unknownCheck again, refresh, check e-Taxes; start again only if nothing happened
The same action fails again and againAsk VAT Portal support
Your phone asks when you started nothingDecline and ask VAT Portal support

When you contact VAT Portal support, give them the action's process number (Process #… on the strip or in the live progress) and the company. Support can see every step of the action, including the parts your access doesn't show.


Common questions#

Can I stop an action that seems stuck?

Yes, if you started it and your access allows stopping processes. See Following an e-Taxes action. What was already done stays done.

The window says the documents are no longer eligible.

In the Tax module, on incoming invoices, the window says The selected documents are no longer eligible for this action. Refresh and review them before retrying. when the documents changed after you selected them. Refresh the list and select them again.

The action failed. Did VAT Portal change my documents anyway?

Only what e-Taxes accepted before the failure. Refresh the document to see its latest status.


Keep reading

Related articles