1 // Partial Copyright Jerome Benoit. 2021-2023. All Rights Reserved.
3 import { parentPort
} from
'node:worker_threads';
5 import type { JSONSchemaType
} from
'ajv';
9 ChargingStationConfigurationUtils
,
12 } from
'../../../charging-station';
13 import { OCPPError
} from
'../../../exception';
15 type ChangeAvailabilityResponse
,
16 type ChangeConfigurationResponse
,
17 type ClearChargingProfileResponse
,
20 type GetConfigurationResponse
,
21 type GetDiagnosticsResponse
,
24 OCPP16AuthorizationStatus
,
25 type OCPP16AuthorizeRequest
,
26 type OCPP16AuthorizeResponse
,
27 type OCPP16BootNotificationResponse
,
28 OCPP16ChargePointStatus
,
29 type OCPP16DataTransferResponse
,
30 type OCPP16DiagnosticsStatusNotificationResponse
,
31 type OCPP16FirmwareStatusNotificationResponse
,
32 type OCPP16GetCompositeScheduleResponse
,
33 type OCPP16HeartbeatResponse
,
34 OCPP16IncomingRequestCommand
,
35 type OCPP16MeterValuesRequest
,
36 type OCPP16MeterValuesResponse
,
38 OCPP16StandardParametersKey
,
39 type OCPP16StartTransactionRequest
,
40 type OCPP16StartTransactionResponse
,
41 type OCPP16StatusNotificationResponse
,
42 type OCPP16StopTransactionRequest
,
43 type OCPP16StopTransactionResponse
,
44 type OCPP16TriggerMessageResponse
,
45 type OCPP16UpdateFirmwareResponse
,
47 RegistrationStatusEnumType
,
49 type SetChargingProfileResponse
,
50 type UnlockConnectorResponse
,
51 } from
'../../../types';
52 import { Constants
, Utils
, logger
} from
'../../../utils';
53 import { OCPP16ServiceUtils
, OCPPResponseService
} from
'../internal';
55 const moduleName
= 'OCPP16ResponseService';
57 export class OCPP16ResponseService
extends OCPPResponseService
{
58 public jsonIncomingRequestResponseSchemas
: Map
<
59 OCPP16IncomingRequestCommand
,
60 JSONSchemaType
<JsonObject
>
63 private responseHandlers
: Map
<OCPP16RequestCommand
, ResponseHandler
>;
64 private jsonSchemas
: Map
<OCPP16RequestCommand
, JSONSchemaType
<JsonObject
>>;
66 public constructor() {
67 // if (new.target?.name === moduleName) {
68 // throw new TypeError(`Cannot construct ${new.target?.name} instances directly`);
70 super(OCPPVersion
.VERSION_16
);
71 this.responseHandlers
= new Map
<OCPP16RequestCommand
, ResponseHandler
>([
72 [OCPP16RequestCommand
.BOOT_NOTIFICATION
, this.handleResponseBootNotification
.bind(this)],
73 [OCPP16RequestCommand
.HEARTBEAT
, this.emptyResponseHandler
.bind(this)],
74 [OCPP16RequestCommand
.AUTHORIZE
, this.handleResponseAuthorize
.bind(this)],
75 [OCPP16RequestCommand
.START_TRANSACTION
, this.handleResponseStartTransaction
.bind(this)],
76 [OCPP16RequestCommand
.STOP_TRANSACTION
, this.handleResponseStopTransaction
.bind(this)],
77 [OCPP16RequestCommand
.STATUS_NOTIFICATION
, this.emptyResponseHandler
.bind(this)],
78 [OCPP16RequestCommand
.METER_VALUES
, this.emptyResponseHandler
.bind(this)],
79 [OCPP16RequestCommand
.DIAGNOSTICS_STATUS_NOTIFICATION
, this.emptyResponseHandler
.bind(this)],
80 [OCPP16RequestCommand
.DATA_TRANSFER
, this.emptyResponseHandler
.bind(this)],
81 [OCPP16RequestCommand
.FIRMWARE_STATUS_NOTIFICATION
, this.emptyResponseHandler
.bind(this)],
83 this.jsonSchemas
= new Map
<OCPP16RequestCommand
, JSONSchemaType
<JsonObject
>>([
85 OCPP16RequestCommand
.BOOT_NOTIFICATION
,
86 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16BootNotificationResponse
>(
87 '../../../assets/json-schemas/ocpp/1.6/BootNotificationResponse.json',
93 OCPP16RequestCommand
.HEARTBEAT
,
94 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16HeartbeatResponse
>(
95 '../../../assets/json-schemas/ocpp/1.6/HeartbeatResponse.json',
101 OCPP16RequestCommand
.AUTHORIZE
,
102 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16AuthorizeResponse
>(
103 '../../../assets/json-schemas/ocpp/1.6/AuthorizeResponse.json',
109 OCPP16RequestCommand
.START_TRANSACTION
,
110 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16StartTransactionResponse
>(
111 '../../../assets/json-schemas/ocpp/1.6/StartTransactionResponse.json',
117 OCPP16RequestCommand
.STOP_TRANSACTION
,
118 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16StopTransactionResponse
>(
119 '../../../assets/json-schemas/ocpp/1.6/StopTransactionResponse.json',
125 OCPP16RequestCommand
.STATUS_NOTIFICATION
,
126 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16StatusNotificationResponse
>(
127 '../../../assets/json-schemas/ocpp/1.6/StatusNotificationResponse.json',
133 OCPP16RequestCommand
.METER_VALUES
,
134 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16MeterValuesResponse
>(
135 '../../../assets/json-schemas/ocpp/1.6/MeterValuesResponse.json',
141 OCPP16RequestCommand
.DIAGNOSTICS_STATUS_NOTIFICATION
,
142 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16DiagnosticsStatusNotificationResponse
>(
143 '../../../assets/json-schemas/ocpp/1.6/DiagnosticsStatusNotificationResponse.json',
149 OCPP16RequestCommand
.DATA_TRANSFER
,
150 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16DataTransferResponse
>(
151 '../../../assets/json-schemas/ocpp/1.6/DataTransferResponse.json',
157 OCPP16RequestCommand
.FIRMWARE_STATUS_NOTIFICATION
,
158 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16FirmwareStatusNotificationResponse
>(
159 '../../../assets/json-schemas/ocpp/1.6/FirmwareStatusNotificationResponse.json',
165 this.jsonIncomingRequestResponseSchemas
= new Map([
167 OCPP16IncomingRequestCommand
.RESET
,
168 OCPP16ServiceUtils
.parseJsonSchemaFile
<GenericResponse
>(
169 '../../../assets/json-schemas/ocpp/1.6/ResetResponse.json',
175 OCPP16IncomingRequestCommand
.CLEAR_CACHE
,
176 OCPP16ServiceUtils
.parseJsonSchemaFile
<GenericResponse
>(
177 '../../../assets/json-schemas/ocpp/1.6/ClearCacheResponse.json',
183 OCPP16IncomingRequestCommand
.CHANGE_AVAILABILITY
,
184 OCPP16ServiceUtils
.parseJsonSchemaFile
<ChangeAvailabilityResponse
>(
185 '../../../assets/json-schemas/ocpp/1.6/ChangeAvailabilityResponse.json',
191 OCPP16IncomingRequestCommand
.UNLOCK_CONNECTOR
,
192 OCPP16ServiceUtils
.parseJsonSchemaFile
<UnlockConnectorResponse
>(
193 '../../../assets/json-schemas/ocpp/1.6/UnlockConnectorResponse.json',
199 OCPP16IncomingRequestCommand
.GET_CONFIGURATION
,
200 OCPP16ServiceUtils
.parseJsonSchemaFile
<GetConfigurationResponse
>(
201 '../../../assets/json-schemas/ocpp/1.6/GetConfigurationResponse.json',
207 OCPP16IncomingRequestCommand
.CHANGE_CONFIGURATION
,
208 OCPP16ServiceUtils
.parseJsonSchemaFile
<ChangeConfigurationResponse
>(
209 '../../../assets/json-schemas/ocpp/1.6/ChangeConfigurationResponse.json',
215 OCPP16IncomingRequestCommand
.GET_COMPOSITE_SCHEDULE
,
216 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16GetCompositeScheduleResponse
>(
217 '../../../assets/json-schemas/ocpp/1.6/GetCompositeScheduleResponse.json',
223 OCPP16IncomingRequestCommand
.SET_CHARGING_PROFILE
,
224 OCPP16ServiceUtils
.parseJsonSchemaFile
<SetChargingProfileResponse
>(
225 '../../../assets/json-schemas/ocpp/1.6/SetChargingProfileResponse.json',
231 OCPP16IncomingRequestCommand
.CLEAR_CHARGING_PROFILE
,
232 OCPP16ServiceUtils
.parseJsonSchemaFile
<ClearChargingProfileResponse
>(
233 '../../../assets/json-schemas/ocpp/1.6/ClearChargingProfileResponse.json',
239 OCPP16IncomingRequestCommand
.REMOTE_START_TRANSACTION
,
240 OCPP16ServiceUtils
.parseJsonSchemaFile
<GenericResponse
>(
241 '../../../assets/json-schemas/ocpp/1.6/RemoteStartTransactionResponse.json',
247 OCPP16IncomingRequestCommand
.REMOTE_STOP_TRANSACTION
,
248 OCPP16ServiceUtils
.parseJsonSchemaFile
<GenericResponse
>(
249 '../../../assets/json-schemas/ocpp/1.6/RemoteStopTransactionResponse.json',
255 OCPP16IncomingRequestCommand
.GET_DIAGNOSTICS
,
256 OCPP16ServiceUtils
.parseJsonSchemaFile
<GetDiagnosticsResponse
>(
257 '../../../assets/json-schemas/ocpp/1.6/GetDiagnosticsResponse.json',
263 OCPP16IncomingRequestCommand
.TRIGGER_MESSAGE
,
264 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16TriggerMessageResponse
>(
265 '../../../assets/json-schemas/ocpp/1.6/TriggerMessageResponse.json',
271 OCPP16IncomingRequestCommand
.DATA_TRANSFER
,
272 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16DataTransferResponse
>(
273 '../../../assets/json-schemas/ocpp/1.6/DataTransferResponse.json',
279 OCPP16IncomingRequestCommand
.UPDATE_FIRMWARE
,
280 OCPP16ServiceUtils
.parseJsonSchemaFile
<OCPP16UpdateFirmwareResponse
>(
281 '../../../assets/json-schemas/ocpp/1.6/UpdateFirmwareResponse.json',
287 this.validatePayload
= this.validatePayload
.bind(this) as (
288 chargingStation
: ChargingStation
,
289 commandName
: OCPP16RequestCommand
,
294 public async responseHandler(
295 chargingStation
: ChargingStation
,
296 commandName
: OCPP16RequestCommand
,
298 requestPayload
: JsonType
301 chargingStation
.isRegistered() === true ||
302 commandName
=== OCPP16RequestCommand
.BOOT_NOTIFICATION
305 this.responseHandlers
.has(commandName
) === true &&
306 OCPP16ServiceUtils
.isRequestCommandSupported(chargingStation
, commandName
) === true
309 this.validatePayload(chargingStation
, commandName
, payload
);
310 await this.responseHandlers
.get(commandName
)(chargingStation
, payload
, requestPayload
);
313 `${chargingStation.logPrefix()} ${moduleName}.responseHandler: Handle response error:`,
321 ErrorType
.NOT_IMPLEMENTED
,
322 `${commandName} is not implemented to handle response PDU ${JSON.stringify(
333 ErrorType
.SECURITY_ERROR
,
334 `${commandName} cannot be issued to handle response PDU ${JSON.stringify(
338 )} while the charging station is not registered on the central server.`,
345 private validatePayload(
346 chargingStation
: ChargingStation
,
347 commandName
: OCPP16RequestCommand
,
350 if (this.jsonSchemas
.has(commandName
) === true) {
351 return this.validateResponsePayload(
354 this.jsonSchemas
.get(commandName
),
359 `${chargingStation.logPrefix()} ${moduleName}.validatePayload: No JSON schema found for command '${commandName}' PDU validation`
364 private handleResponseBootNotification(
365 chargingStation
: ChargingStation
,
366 payload
: OCPP16BootNotificationResponse
368 if (payload
.status === RegistrationStatusEnumType
.ACCEPTED
) {
369 ChargingStationConfigurationUtils
.addConfigurationKey(
371 OCPP16StandardParametersKey
.HeartbeatInterval
,
372 payload
.interval
.toString(),
374 { overwrite
: true, save
: true }
376 ChargingStationConfigurationUtils
.addConfigurationKey(
378 OCPP16StandardParametersKey
.HeartBeatInterval
,
379 payload
.interval
.toString(),
381 { overwrite
: true, save
: true }
383 OCPP16ServiceUtils
.startHeartbeatInterval(chargingStation
, payload
.interval
);
385 if (Object.values(RegistrationStatusEnumType
).includes(payload
.status)) {
386 const logMsg
= `${chargingStation.logPrefix()} Charging station in '${
388 }' state on the central server`;
389 payload
.status === RegistrationStatusEnumType
.REJECTED
390 ? logger
.warn(logMsg
)
391 : logger
.info(logMsg
);
394 `${chargingStation.logPrefix()} Charging station boot notification response received: %j with undefined registration status`,
400 private handleResponseAuthorize(
401 chargingStation
: ChargingStation
,
402 payload
: OCPP16AuthorizeResponse
,
403 requestPayload
: OCPP16AuthorizeRequest
405 let authorizeConnectorId
: number;
406 for (const connectorId
of chargingStation
.connectors
.keys()) {
409 chargingStation
.getConnectorStatus(connectorId
)?.authorizeIdTag
=== requestPayload
.idTag
411 authorizeConnectorId
= connectorId
;
415 const authorizeConnectorIdDefined
= !Utils
.isNullOrUndefined(authorizeConnectorId
);
416 if (payload
.idTagInfo
.status === OCPP16AuthorizationStatus
.ACCEPTED
) {
417 authorizeConnectorIdDefined
&&
418 (chargingStation
.getConnectorStatus(authorizeConnectorId
).idTagAuthorized
= true);
420 `${chargingStation.logPrefix()} idTag '${requestPayload.idTag}' accepted${
421 authorizeConnectorIdDefined ? ` on connector id ${authorizeConnectorId}
` : ''
425 if (authorizeConnectorIdDefined
) {
426 chargingStation
.getConnectorStatus(authorizeConnectorId
).idTagAuthorized
= false;
427 delete chargingStation
.getConnectorStatus(authorizeConnectorId
)?.authorizeIdTag
;
430 `${chargingStation.logPrefix()} idTag '${requestPayload.idTag}' rejected with status '${
431 payload.idTagInfo.status
432 }'${authorizeConnectorIdDefined ? ` on connector id ${authorizeConnectorId}` : ''}`
437 private async handleResponseStartTransaction(
438 chargingStation: ChargingStation,
439 payload: OCPP16StartTransactionResponse,
440 requestPayload: OCPP16StartTransactionRequest
442 const connectorId = requestPayload.connectorId;
443 if (connectorId === 0 || chargingStation.hasConnector(connectorId) === false) {
445 `${chargingStation.logPrefix()} Trying to start a transaction on a non existing connector id ${connectorId.toString()}
`
450 chargingStation.getConnectorStatus(connectorId)?.transactionRemoteStarted === true &&
451 chargingStation.getAuthorizeRemoteTxRequests() === true &&
452 chargingStation.getLocalAuthListEnabled() === true &&
453 chargingStation.hasIdTags() &&
454 chargingStation.getConnectorStatus(connectorId)?.idTagLocalAuthorized === false
457 `${chargingStation.logPrefix()} Trying to start a transaction
with a not local authorized idTag $
{
458 chargingStation
.getConnectorStatus(connectorId
)?.localAuthorizeIdTag
459 } on connector id ${connectorId.toString()}
`
461 await this.resetConnectorOnStartTransactionError(chargingStation, connectorId);
465 chargingStation.getConnectorStatus(connectorId)?.transactionRemoteStarted === true &&
466 chargingStation.getAuthorizeRemoteTxRequests() === true &&
467 chargingStation.getMustAuthorizeAtRemoteStart() === true &&
468 chargingStation.getConnectorStatus(connectorId)?.idTagLocalAuthorized === false &&
469 chargingStation.getConnectorStatus(connectorId)?.idTagAuthorized === false
472 `${chargingStation.logPrefix()} Trying to start a transaction
with a not authorized idTag $
{
473 chargingStation
.getConnectorStatus(connectorId
)?.authorizeIdTag
474 } on connector id ${connectorId.toString()}
`
476 await this.resetConnectorOnStartTransactionError(chargingStation, connectorId);
480 chargingStation.getConnectorStatus(connectorId)?.idTagAuthorized &&
481 chargingStation.getConnectorStatus(connectorId)?.authorizeIdTag !== requestPayload.idTag
484 `${chargingStation.logPrefix()} Trying to start a transaction
with an idTag $
{
486 } different from the authorize request one $
{
487 chargingStation
.getConnectorStatus(connectorId
)?.authorizeIdTag
488 } on connector id ${connectorId.toString()}
`
490 await this.resetConnectorOnStartTransactionError(chargingStation, connectorId);
494 chargingStation.getConnectorStatus(connectorId)?.idTagLocalAuthorized &&
495 chargingStation.getConnectorStatus(connectorId)?.localAuthorizeIdTag !== requestPayload.idTag
498 `${chargingStation.logPrefix()} Trying to start a transaction
with an idTag $
{
500 } different from the local authorized one $
{
501 chargingStation
.getConnectorStatus(connectorId
)?.localAuthorizeIdTag
502 } on connector id ${connectorId.toString()}
`
504 await this.resetConnectorOnStartTransactionError(chargingStation, connectorId);
507 if (chargingStation.getConnectorStatus(connectorId)?.transactionStarted === true) {
509 `${chargingStation.logPrefix()} Trying to start a transaction on an already used connector id ${connectorId.toString()}
: %j
`,
510 chargingStation.getConnectorStatus(connectorId)
515 chargingStation.getConnectorStatus(connectorId)?.status !==
516 OCPP16ChargePointStatus.Available &&
517 chargingStation.getConnectorStatus(connectorId)?.status !== OCPP16ChargePointStatus.Preparing
520 `${chargingStation.logPrefix()} Trying to start a transaction on connector id ${connectorId.toString()}
with status $
{
521 chargingStation
.getConnectorStatus(connectorId
)?.status
526 if (!Number.isInteger(payload.transactionId)) {
528 `${chargingStation.logPrefix()} Trying to start a transaction on connector id ${connectorId.toString()}
with a non integer transaction id $
{
529 payload
.transactionId
530 }, converting to integer
`
532 payload.transactionId = Utils.convertToInt(payload.transactionId);
535 if (payload.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED) {
536 chargingStation.getConnectorStatus(connectorId).transactionStarted = true;
537 chargingStation.getConnectorStatus(connectorId).transactionId = payload.transactionId;
538 chargingStation.getConnectorStatus(connectorId).transactionIdTag = requestPayload.idTag;
539 chargingStation.getConnectorStatus(
541 ).transactionEnergyActiveImportRegisterValue = 0;
542 chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue =
543 OCPP16ServiceUtils.buildTransactionBeginMeterValue(
546 requestPayload.meterStart
548 chargingStation.getBeginEndMeterValues() &&
549 (await chargingStation.ocppRequestService.requestHandler<
550 OCPP16MeterValuesRequest,
551 OCPP16MeterValuesResponse
552 >(chargingStation, OCPP16RequestCommand.METER_VALUES, {
554 transactionId: payload.transactionId,
555 meterValue: [chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue],
557 await OCPP16ServiceUtils.sendAndSetConnectorStatus(
560 OCPP16ChargePointStatus.Charging
563 `${chargingStation.logPrefix()} Transaction
with id ${payload.transactionId.toString()} STARTED on $
{
564 chargingStation
.stationInfo
.chargingStationId
565 }#${connectorId.toString()}
for idTag
'${requestPayload.idTag}'`
567 if (chargingStation.stationInfo.powerSharedByConnectors) {
568 chargingStation.powerDivider++;
570 const configuredMeterValueSampleInterval =
571 ChargingStationConfigurationUtils.getConfigurationKey(
573 OCPP16StandardParametersKey.MeterValueSampleInterval
575 chargingStation.startMeterValues(
577 configuredMeterValueSampleInterval
578 ? Utils.convertToInt(configuredMeterValueSampleInterval.value) * 1000
579 : Constants.DEFAULT_METER_VALUES_INTERVAL
583 `${chargingStation.logPrefix()} Starting transaction
with id ${payload.transactionId.toString()} REJECTED
with status '${
584 payload.idTagInfo?.status
585 }', idTag
'${requestPayload.idTag}'`
587 await this.resetConnectorOnStartTransactionError(chargingStation, connectorId);
591 private async resetConnectorOnStartTransactionError(
592 chargingStation: ChargingStation,
595 ChargingStationUtils.resetConnectorStatus(chargingStation.getConnectorStatus(connectorId));
596 chargingStation.stopMeterValues(connectorId);
597 parentPort?.postMessage(MessageChannelUtils.buildUpdatedMessage(chargingStation));
599 chargingStation.getConnectorStatus(connectorId)?.status !== OCPP16ChargePointStatus.Available
601 await OCPP16ServiceUtils.sendAndSetConnectorStatus(
604 OCPP16ChargePointStatus.Available
609 private async handleResponseStopTransaction(
610 chargingStation: ChargingStation,
611 payload: OCPP16StopTransactionResponse,
612 requestPayload: OCPP16StopTransactionRequest
614 const transactionConnectorId = chargingStation.getConnectorIdByTransactionId(
615 requestPayload.transactionId
617 if (Utils.isNullOrUndefined(transactionConnectorId)) {
619 `${chargingStation.logPrefix()} Trying to stop a non existing transaction
with id ${requestPayload.transactionId.toString()}
`
623 chargingStation.getBeginEndMeterValues() === true &&
624 chargingStation.getOcppStrictCompliance() === false &&
625 chargingStation.getOutOfOrderEndMeterValues() === true &&
626 (await chargingStation.ocppRequestService.requestHandler<
627 OCPP16MeterValuesRequest,
628 OCPP16MeterValuesResponse
629 >(chargingStation, OCPP16RequestCommand.METER_VALUES, {
630 connectorId: transactionConnectorId,
631 transactionId: requestPayload.transactionId,
633 OCPP16ServiceUtils.buildTransactionEndMeterValue(
635 transactionConnectorId,
636 requestPayload.meterStop
641 chargingStation.isChargingStationAvailable() === false ||
642 chargingStation.isConnectorAvailable(transactionConnectorId) === false
644 await OCPP16ServiceUtils.sendAndSetConnectorStatus(
646 transactionConnectorId,
647 OCPP16ChargePointStatus.Unavailable
650 await OCPP16ServiceUtils.sendAndSetConnectorStatus(
652 transactionConnectorId,
653 OCPP16ChargePointStatus.Available
656 if (chargingStation.stationInfo.powerSharedByConnectors) {
657 chargingStation.powerDivider--;
659 ChargingStationUtils.resetConnectorStatus(
660 chargingStation.getConnectorStatus(transactionConnectorId)
662 chargingStation.stopMeterValues(transactionConnectorId);
663 parentPort?.postMessage(MessageChannelUtils.buildUpdatedMessage(chargingStation));
664 const logMsg = `${chargingStation.logPrefix()} Transaction
with id ${requestPayload.transactionId.toString()} STOPPED on $
{
665 chargingStation
.stationInfo
.chargingStationId
666 }#${transactionConnectorId?.toString()}
with status '${
667 payload.idTagInfo?.status ?? 'undefined'
670 Utils.isNullOrUndefined(payload.idTagInfo) ||
671 payload.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED