> ## Documentation Index
> Fetch the complete documentation index at: https://nectarclimate.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Input FAQ

> Troubleshooting connections, uploads, reprocessing, manual entry, and invitations.

Use this page to troubleshoot data collection issues in **Data Input**.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="My connection says &#x22;Needs attention.&#x22; What should I do first?">
    Open the connection and run the reconnect flow. Most issues are caused by changed credentials,
    required MFA, or updated utility portal prompts. If the status is **MFA Token Expired**, see the
    [MFA triage flow](/docs/platform/data-input/mfa#triage-flow-fixing-an-mfa-connection) for step-by-step guidance.
  </Accordion>

  <Accordion title="An invitation says it is expired or invalid. Can I recover it?">
    Expired invitations cannot be reused. Create a fresh invitation and resend it from **Data Input > Invitations**. If links keep expiring
    immediately, confirm the recipient is opening the latest URL. Legacy magic links behave the same way — if you still have any outstanding, switch to invitations for future shares.
  </Accordion>

  <Accordion title="Why did browser sign-in fail during connection setup?">
    Browser-based sign-in may fail when utility portals block the flow or additional auth steps are
    required. Retry with standard credential entry or complete reconnect with updated prompts.
  </Accordion>

  <Accordion title="My upload failed. Which file limits should I check?">
    Verify file type, size, and batch size limits. Large uploads may need splitting into smaller
    batches, and unsupported formats should be converted before retrying.
  </Accordion>

  <Accordion title="How do I reprocess an uploaded document?">
    Open the upload job in [**Data Input > Uploads**](https://dash.nectarclimate.com/data-input/uploads),
    find the document, and choose **Reprocess with feedback**. Add required feedback (and optional site or account overrides), then submit.
    Nectar starts a new job with source **Reprocess**, marks the original document **Reprocessed**, and replaces any bill created from that file.
    See [Upload job details — Reprocess with feedback](/docs/platform/data-input/upload-detail#reprocess-with-feedback).
  </Accordion>

  <Accordion title="What happens to the existing bill when I reprocess?">
    The bill created from that document is deleted and replaced by the result of the new processing run.
    For a merged PDF that was split into multiple bills, those bills are replaced together. Track the new job from **Data Input > Uploads**.
  </Accordion>

  <Accordion title="Can I preview the file I originally uploaded?">
    Yes. On the [upload job details](/docs/platform/data-input/upload-detail) page, use **Original** on each document row to preview or download the as-uploaded file.
    Originals are available as soon as the job is created, including while processing is still running.
  </Accordion>

  <Accordion title="I connected successfully but do not see bills yet.">
    Initial bill pulls typically take 1–3 business days after a successful connection. The first check runs within an hour; after that, Nectar checks weekly for new bills. If no bills appear after 3 days:

    1. Verify the connection status is **Connected** (not Pending or Error)
    2. Confirm the **data collection start date** includes the period you expect bills for
    3. Check that the utility portal actually has downloadable statements for those dates

    Some utilities take up to a week to make new bills available in their portal. If it's been more than 5 business days and the connection is healthy, email [support@nectarclimate.com](mailto:support@nectarclimate.com) with the company name and connection.
  </Accordion>

  <Accordion title="How long does upload processing take?">
    Most documents are processed in **under 5 minutes**. Typical timing by volume:

    | Upload size      | Expected time   |
    | ---------------- | --------------- |
    | 1–5 documents    | Under 5 minutes |
    | 6–20 documents   | 5–15 minutes    |
    | 20–100 documents | 15–60 minutes   |

    Track progress on the [**Data Input > Uploads**](https://dash.nectarclimate.com/data-input/uploads) page — each document shows its own status (Processing, Processed, Duplicate, Error, Non-utility). If a document stays in **Processing** for more than 30 minutes, it likely encountered an extraction issue and will resolve to **Error**. Try [reprocessing with feedback](/docs/platform/data-input/upload-detail#reprocess-with-feedback) or contact [support@nectarclimate.com](mailto:support@nectarclimate.com).
  </Accordion>

  <Accordion title="My connection or upload seems stuck. When should I escalate?">
    Use this timing guide to decide whether to wait or contact support:

    | Scenario                    | Normal timing              | Escalate after            |
    | --------------------------- | -------------------------- | ------------------------- |
    | New connection (first pull) | 1–3 business days          | 5 business days           |
    | Weekly bill check           | Runs once per week         | 2 missed cycles (14 days) |
    | Upload processing           | Under 5 minutes per doc    | 30 minutes per document   |
    | Reconnect after error       | Picks up next weekly check | 7 days with no new data   |

    When escalating, include: company name, connection or upload job ID, when the issue started, and any error messages you see. Email [support@nectarclimate.com](mailto:support@nectarclimate.com).
  </Accordion>

  <Accordion title="I deleted a connection by accident. Can I recover it?">
    **Deleted connections cannot be restored.** Deletion is permanent — it removes the connection and stops future collection, but all historical bills, accounts, and meters that were already collected remain in your data inventory.

    If you need to resume collection for the same utility account, create a new connection. Nectar will match incoming bills to the existing accounts and meters automatically (based on account numbers and meter identifiers), so you won't get duplicates.

    **Tip:** If you only want to temporarily stop collection, use **Deactivate** instead of Delete — deactivation is reversible with one click.
  </Accordion>

  <Accordion title="How do I know whether to use Connections, Uploads, or Manual entry?">
    Use **Connections** for recurring automation, **Uploads** for historical or one-off documents, and
    **Manual entry** for corrections or non-digital bills.
  </Accordion>

  <Accordion title="A recipient cannot complete an invitation flow. What should I send support?">
    Include the company name, time of attempt, utility provider, and screenshots/error text. This
    helps support identify whether the issue is credentials, MFA, or provider-side behavior. Check the invitation's **Activity log** first — it shows whether the link was viewed and where the flow stopped.
  </Accordion>

  <Accordion title="Where can developers implement embedded connection workflows?">
    Start with [Connection invitations](/docs/developer-guide/connection-invitations) and
    [Connection statuses](/docs/developer-guide/connection-statuses) in the Developer Guide.
  </Accordion>
</AccordionGroup>

## Related data input docs

<CardGroup cols={2}>
  <Card title="Data input overview" icon="book-open" href="/docs/platform/data-input/overview">
    Compare all input methods and when to use each.
  </Card>

  <Card title="Connections" icon="plug" href="/docs/platform/data-input/connections">
    Set up and manage recurring portal syncs.
  </Card>

  <Card title="Uploads" icon="upload" href="/docs/platform/data-input/uploads">
    Ingest PDF/image bills, preview originals, and reprocess with feedback.
  </Card>

  <Card title="Troubleshooting" icon="screwdriver-wrench" href="/docs/platform/data-input/troubleshooting">
    Detailed issue-specific guidance.
  </Card>
</CardGroup>