CFE validation service

Address service

Address service allows to validate a CFE document and get the structured data of residence and owner of the service contract. Also, the service consults directly in CFE to verify.

Web service description

Validate CFE document and address

This method performs the validation of the CFE document and obtains the information of the contract by OCR (Optical Character Recognition), verifies before the CFE if the contract number presented in the CFE address document.

~/api/address

Parameters

Tag Type Required Description
imageFile file yes CFE image type .jpg, .jpeg or png.

Headers

Tag Type Required Description
apikey string yes Customer key.

FormData

{
  "imageFile": "file"
}

Response:

Name Type Description
Correct:
valid boolean "Success"
data
name: string Name of the CFE service contract owner.
addressline1 string Street and number.
addressline2 string Street reference.
addressline3 string Suburb and postal code.
addressline4 string City and state.
payment double Total amount invoiced.
period string Billed period.
serviceNumber String Service contract number.
paymentDeadline string Payment deadline.
geocodeUrl string URL of the geographical location of the address.
lat string Latitude.
lng string Length.
Error
code: integer Error code.
message string "Error message".

JSON

{
  "valid": boolean,
  "data": {
    "name": string,
    "addressline1": string,
    "addressline2": string,
    "addressline3": string,
    "addressline4": string,
    "totalPayment": double,
    "period": string,
    "serviceNumber": string,
    "paymentDeadline": string,
    "geocodeUrl": string,
    "lat": float,
    "lng": float
  },
  "warnings": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Error

{
  "error": "Error code",
  "message": "Error message"
}

Service messages

Code Message Description
ADS001 Structure of data. Indicates whether the request was successful or unsuccessful. If everything goes well, it will show the data correctly.
ADS002 No matches found. Message to show that no information was found or when the OCR could not be read, or the file has poor quality.
ADS003 The file format is not correct. Message displayed when the request contains an incorrect document, when there are files different than .png, .jpg or .pdf or when the document does not correspond to the standard format.
ADS004 Incorrect information. Message displayed when the document received does not corresponds to CFE.
ADS005 The $0$ field is required. Message displayed when a request is received with null parameters or blank spaces.
ADS006 The document is not valid. Message displayed when the document has expired.
ADS007 File size is larger than expected. Message displayed when the document exceeds 5MB.
ADS008 Inconsistent data found. Message displayed when the information obtained through the OCR scanning does not correspond to what is in the document.
ADS009 The apiKey is not valid. Message displayed when the apiKey is incorrect.
ADS010 Server response failed. Message displayed when server response failed.
ADS011 Response time has exceeded. Message displayed when response time is exceeded.
ADS012 Error loading image. Message displayed when the service cannot process the image received.