가이드북

테마

파트너 제품 찾아서 계약하고 받기 ​

이럴 때 씁니다 ​

파트너가 공개한 제품 데이터(설계 데이터, DPP 등)를 찾아 계약을 맺고 우리 쪽으로 내려받을 때 씁니다. 순서는 파트너의 디지털 트윈 레지스트리 API와 관계 맺기 → 탐색 → 데이터별 계약 → 전송 → 다운로드입니다. 첫 단계는 파트너마다 한 번만 합니다.

시작하기 전에 ​

  • 파트너의 BPNL
  • 우리 쪽 접근 정책·계약 정책 한 쌍 → 첫 정책 만들기
  • 멤버 계정은 그룹에 속해 있어야 합니다.

따라 하기 ​

  1. 파트너의 디지털 트윈 레지스트리 API와 관계 맺기(파트너마다 처음 한 번) — 공유 → 디지털 트윈 레지스트리 API → 관계 추가에서 1/2에 파트너 BPNL을 넣고, 2/2에서 상대 API 연결을 체크한 뒤 관계 만들기를 누릅니다. 계약·전송·EDR 발급은 자동으로 진행되고, 파트너 관계 테이블에서 그 행의 상태가 연결 중 → 연결됨, 상태 열이 양방향 정상이 되면 준비된 것입니다. 이 관계가 없으면 탐색 화면에 "디지털 트윈 레지스트리 API 계약이 선행되어야 합니다."가 뜹니다.
  2. 제품 관리 → 탐색 — 기업 BPNL을 넣고 탐색을 누릅니다. 제조사 부품 ID나 시리얼 번호를 함께 넣으면 좁혀서 볼 수 있습니다. 비워 두면 그 기업의 디지털 트윈을 모두 조회합니다.

제품 관리 → 탐색 3. 결과 카드에서 펼치기로 제공 데이터 목록을 열고, 받을 데이터 옆의 이 데이터로 계약 시작을 누릅니다. 계약 가능 배지가 있는 데이터만 진행됩니다. 4. 계약 마법사 4단계가 열립니다. 계약 정보 입력 → 상대 기업 정보 입력 → 대상 선택 → 정책 검토. 상대 기업과 대상, 유스케이스 유형은 탐색에서 넘어와 채워져 있습니다. 마지막에 위의 접근 및 계약 정책에 동의합니다를 체크하고 계약 제출을 누르면 "계약이 성공적으로 생성되었습니다!"가 뜹니다. 5. 제품 관리 → 계약에서 방향 보낸 계약으로 상태를 봅니다. 협상 진행 중 → 협상 성립이 되면 계약 상세를 열어 전송 시작을 누릅니다.

제품 관리 → 계약 6. 상태가 데이터 수신 가능이 되면 데이터 다운로드를 누릅니다. 이미 받은 계약은 "데이터가 이미 다운로드되었습니다"와 수신 데이터 보기가 표시됩니다.

탐색한 트윈을 제품으로 가져와 계약하기 ​

탐색에서 찾은 트윈은 가져오기로 제품 목록에 올려 두고, 제품 상세에서 서브모델별로 계약할 수 있습니다. 트윈은 한 번에 하나씩 가져옵니다.

  1. 탐색 결과에서 가져올 트윈을 열고 가져오기를 누릅니다. 가져오면 버튼이 제품에서 보기로 바뀌고, 제품 목록에 타사 제품으로 나타납니다.
  2. 제품 상세를 열면 서브모델마다 상태가 보입니다. 상태는 계약 필요 · 계약 중 · 받음 · 계약 불가 · 상대 트윈에서 없어짐 중 하나입니다.
  3. 계약 필요인 서브모델 옆의 계약하기를 누르면 위 계약 마법사가 열립니다. 계약 중인 서브모델은 계약 보기로 계약 상세를 엽니다. 데이터는 자동으로 내려받지 않습니다. 계약이 성립되면 계약 보기로 계약 상세를 열어 위 5·6단계처럼 데이터 다운로드를 눌러야 합니다. 그러면 상태가 받음으로 바뀌고, 받은 데이터가 그 자리에 채워집니다.
  4. 상대 기업이 트윈을 바꿨을 수 있으면 트윈 다시 불러오기를 누릅니다. 서브모델 목록과 상태를 상대 트윈 기준으로 다시 맞춥니다.
  5. 더 이상 목록에 둘 필요가 없으면 목록에서 빼기를 누릅니다. 목록에서 빼도 계약과 받은 데이터는 계약 화면에 남습니다.

알아 둘 점은 다음과 같습니다.

  • 목록에 **열람 권한 없음(고객으로 지정되지 않음)**으로 표시된 트윈은 펼치거나 가져오거나 계약할 수 없습니다. 상대 기업이 트윈 정보를 그 제품의 제조사와 고객에게만 공개하기 때문입니다. 상대 기업에 우리를 그 제품의 고객으로 지정해 달라고 요청하세요.
  • 제조사 품번이 공개되지 않은 트윈은 가져올 수 없습니다.
  • 생산 데이터(Part Instance)만 가져와도 제품이 생깁니다. 이때 제품 상세의 같은 품번 설계 트윈 찾기를 누르면 상대 기업에서 같은 품번의 설계 트윈을 찾아 붙입니다. 찾지 못하면 안내가 나옵니다.
  • 계약 불가는 상대 기업이 지금은 그 데이터를 계약할 수 있게 열어 두지 않은 상태입니다. 트윈 다시 불러오기로 다시 확인합니다.
  • 상대 트윈에서 없어짐은 상대 기업 트윈에서 그 서브모델이 사라진 상태입니다. 이미 받은 데이터와 계약은 계약 화면에 남아 있습니다.

끝나면 이렇게 보입니다 ​

  • 탐색에서 가져오기를 한 트윈은 제품 목록에 타사 제품 배지로 보이고, 받은 데이터는 그 제품 상세에 채워집니다. → 받은 제품 데이터 확인하기
  • 카탈로그에서 바로 계약해 받은 데이터는 제품 목록이 아니라 계약 상세의 수신 데이터 보기에서 봅니다.
  • 제품 관리 → 계약 목록에 이 계약이 데이터 공유 중 상태로 남습니다.

안 되면 ​

  • 상태가 협상 결렬입니다 → 파트너의 정책 조건(허용 BPNL, 사용 목적)에 우리가 맞지 않는 경우가 많습니다. 파트너에게 그 데이터의 접근 정책을 확인해 달라고 하세요.
  • 상태가 전송 요청 실패입니다 → 잠시 후 계약 상세에서 전송 시작을 다시 눌러 보고, 반복되면 계약 ID와 함께 문의하세요.
  • "선택한 자산이 DTR 정보와 다릅니다"가 뜹니다 → 파트너 카탈로그와 디지털 트윈 정보가 어긋난 상태입니다. 진행할 수 없으니 파트너에게 알려 주세요.
  • 상대 기업 정보 입력에서 "인피리움에 등록되지 않은 기업의 BPN 입니다."와 "진행하려면 상대 기업의 DSP 주소를 입력하세요."가 뜹니다(오류가 아닌 안내입니다) → 파트너가 이 플랫폼 밖의 기업입니다. 파트너에게 커넥터의 DSP 주소(예: https://provider.example.com/api/v1/dsp)를 받아 입력하세요. 형식이 맞으면 입력란이 녹색으로 바뀌고 다음을 누를 수 있습니다. 이후 요청은 플랫폼 외부 커넥터로 직접 전송됩니다.
  • "유스케이스 유형을 직접 선택하세요"가 뜹니다 → 표준 목록에 없는 데이터 종류입니다. 파트너에게 어떤 데이터인지 확인한 뒤 유스케이스를 직접 고릅니다.
  • 계약은 됐는데 데이터 다운로드 버튼이 없습니다 → 디지털 트윈 레지스트리 API·품질 알림 API 같은 API 계약은 이 화면에서 내려받지 않습니다. 해당 기능이 채널을 자동으로 씁니다.

이 안내서는 현재 저장소에 구현된 화면을 기준으로 작성합니다.