> For the complete documentation index, see [llms.txt](https://grid-exchange-fabric.gitbook.io/gxf/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://grid-exchange-fabric.gitbook.io/gxf/domains/smartmetering/smartmeteringws/installation/couplembusdevice.md).

# CoupleMbusDevice

## Description

CoupleMbusDevice is a request to couple a gateway and a m-bus device. The request needs the following parameters:

* DeviceIdentification
* MbusDeviceIdentification
* Force

All requests have similar response behaviour which is described in [ResponseMessages](/gxf/domains/smartmetering/responsemessages.md)

If Force has value true, the check if Mbus device is connected to other device will be ignored

[GetCoupleMbusDeviceResponse](/gxf/domains/smartmetering/smartmeteringws/installation/getcouplembusdeviceresponse.md) returns if the result is successful from the request. The response request contains the DeviceIdentification and CorrelationUid which is received from the CoupleMbusDevice request.

## References

XSD: [sm-installation.xsd](https://github.com/OSGP/open-smart-grid-platform/blob/development/osgp/shared/osgp-ws-smartmetering/src/main/resources/schemas/sm-installation.xsd)

WSDL: [SmartMeteringInstallation.wsdl](https://github.com/OSGP/open-smart-grid-platform/blob/development/osgp/shared/osgp-ws-smartmetering/src/main/resources/SmartMeteringInstallation.wsdl)