KIO Link
KIO Link XC API
KIO Link APIHuawei BMSHuawei Alert
KIO Link XC API
KIO Link APIHuawei BMSHuawei Alert
  1. XC/IC Requests
  • DocuSign
    • Overview
    • List a XC request's DocuSign envelopes
      GET
    • Get an embeded URL signature for a XC Request
      GET
    • Regenerate a URL signature for the current signer
      GET
    • List the order of signers of a DocuSign Envelope
      GET
    • Create a DocuSign envelope for a XC request
      POST
    • Resend email & recover URL signature for a XC request
      POST
    • Create a DocuSign envelope for multiple signers
      POST
  • XC Client Prices
    • Overview
    • List XC client prices
      GET
    • Get a XC client's price
      GET
    • Create a XC client's price
      POST
    • Update a XC client's price
      PATCH
    • Delete a XC client's price
      DELETE
  • XC Comments
    • Overview
    • List XC comments
    • Get a XC comment
    • Create a XC comment
    • Update a XC comment
    • Delete a XC comment
  • XC Connections
    • Overview
    • List XC connections
    • Get a XC connection
    • Create a XC connection
    • Update a XC connection
    • Delete a XC connection
  • XC Contract Settings
    • Overview
    • List XC contract settings
    • Get a XC contract setting
    • Get a XC Request's contract setting
    • Create a XC contract setting
    • Update a XC contract setting
    • Delete a XC contract setting
  • XC Contract Setting Participants
    • Overview
    • List all XC contract settings participants
    • List a XC contract settings participants
    • Get a XC contract settings participant
    • Create a XC contract settings participant
    • Update a XC contract settings participant
    • Delete a XC contract settings participant
  • XC Data Centers
    • Overview
    • List XC datacenters
    • Create a XC datacenter
    • Update a XC datacenter
    • Delete a XC datacenter
  • XC Documents
    • Overview
    • List XC documents
    • Get a XC document's metadata
    • Get a XC document download URL
    • Get a XC document binary file
    • Upload a XC document
    • Delete a XC document
  • XC Reports
    • Overview
    • Download XC requests report
    • Download XC satisfaction survey report
    • Download XC connections report
  • XC Requests
    • Overview
    • List XC requests
    • Get a XC request
    • Get a XC request (complete details)
    • Create a XC request
    • Upsert a XC request draft
    • Update a XC request's general data
    • Change a XC request's status
    • Delete a XC request
    • Revert a XC request to Revision
  • XC Salesforce
    • Overview
    • Accounts
      • Overview
      • List accounts
      • Get an account
    • Opportunities
      • Overview
      • Attachments
        • Overview
        • List opportunity attachments
        • Upload an opportunity attachment
        • Download an opportunity file
      • List opportunities
      • Get an opportunity
      • Create an opportunity
      • Update an opportunity
    • Products
      • Overview
      • List products
      • Get a product
    • Project Requests
      • Overview
      • List project requests
      • Get a project request
      • Create a project request
      • Update a project request
    • Users
      • Overview
      • List users
      • Get a user
    • XC/IC Requests
      • Overview
      • Attachments
        • Overview
        • List XC/IC attachments
        • Upload a XC/IC attachment
        • Download a XC/IC file
      • List XC/IC requests
        GET
      • List all KIO Link connections from Salesforce XC/IC requests
        GET
      • Get a XC/IC request
        GET
      • Create a XC/IC request
        POST
      • Update a XC/IC request
        PATCH
  • XC Satisfaction Survey
    • Overview
    • List XC satisfaction surveys
    • Get a XC satisfaction survey
    • Get a XC satisfaction survey per user
    • Create XC satisfaction survey
  • XC Statuses
    • Overview
    • List XC statuses
    • Get a XC status
    • Create a XC status
    • Update a XC status
    • Delete a XC status
  • XC Status Histories
    • Overview
    • List XC status histories
    • List XC status history time summary
    • Get a XC status history record
  • Schemas
    • DocuSign
      • DocuSign Envelope Signer
      • DocuSign Signing URL Result
      • DocuSign Signer Routing
      • DocuSign Resend Result
      • DocuSign Envelope
    • XC Client Prices
      • XC Client Price
    • XC Comments
      • XC Comment
    • XC Connections
      • XC Connection
    • XC Contract Settings
      • XC Contract Setting
    • XC Contract Setting Participants
      • XC Contract Setting Participant
    • XC Data Centers
      • XC Datacenter
    • XC Documents
      • XC Document
    • XC Requests
      • XC Request With Relations
      • XC Request List Item
      • XC Request
      • XC Request With Details
    • XC Salesforce
      • Salesforce Connection
      • Salesforce Account
      • Salesforce User
      • Salesforce Product
      • Salesforce Opportunity List Item
      • Salesforce Opportunity
      • Salesforce Opportunity Write Result
      • Salesforce Attachment
      • Salesforce Attachment Upload Result
      • Salesforce Attachment Download Result
      • Salesforce Request List Item
      • Salesforce Request Point
      • Salesforce Request
      • Salesforce Request Write Result
      • Salesforce Project Request
      • Salesforce Project Request Write Result
      • Salesforce Quote
      • Salesforce Quote Line
    • XC Satisfaction Surveys
      • XC Satisfaction Survey
    • XC Statuses
      • XC Status
    • XC Status Histories
      • XC Status Time
      • XC Status Stage Time
      • XC Status History
    • Error
    • Date Metadata
    • Pagination Metadata
  1. XC/IC Requests

Overview

XC/IC Requests#

Live read/write proxy to Salesforce LOA__c records — the individual cross-connect/intra-connect request within an Opportunity, describing the physical Point A ↔ Point B connection to implement. Also includes a KIO Link–enriched connections listing that blends this data with local records.

Concepts#

Always linked to an Opportunity: opportunity_id is required on create.
point_a / point_b: each is a full physical-connection spec — site, equipment, port, phase_or_room, rack_and_coordinate, wire_type, wire_category, wire_connector are all required within each point; account_id is optional.
account_id on points A/B is intentionally optional on create: clients don't have access to KIO Link's Salesforce customer list, so this is filled in later by the XC Lead via PATCH, who does have that access.
status defaults to Solicitada; wire_status defaults to Nueva XC.
search (on List XC/IC requests) matches the request's own code/folio, or its linked Opportunity's ID, name, or number.
List connections (GET /xc/salesforce/connections) is a separate, business-aware view: it enriches local KIO Link connection data with Salesforce request data, and supports filtering by account name on Point A, Point B, or the Opportunity. For business users, these filters (plus search) can only further restrict the rows they're already allowed to see (payer, or a match on Point A/Point B) — never expand visibility beyond that.

Endpoints#

List XC/IC requests#

GET /v1/xc/salesforce/requests

Get a XC/IC request#

GET /v1/xc/salesforce/requests/{id}

Create a XC/IC request#

POST /v1/xc/salesforce/requests

Update a XC/IC request#

PATCH /v1/xc/salesforce/requests/{id}

List all KIO Link connections from Salesforce XC/IC requests#

GET /v1/xc/salesforce/connections

Attachments#

See the Attachments subfolder for listing, uploading, and downloading LOA files.

Source#

Router: routes/v1/xc/salesforce.router.js
Controllers: controllers/salesforce/requests.controller.js, controllers/salesforce/connections.controller.js
Services: services/salesforce/requests.service.js, services/salesforce/connections.service.js
Schemas: schemas/salesforce/request.schema.js, schemas/salesforce/connections.schema.js
Modified at 2026-09-25 18:33:55
Previous
Get a user
Next
Overview
Built with